Oracle 19c拔出PDB时提示ORA-65026 XML元数据文件错误如何解决

问题场景 #

• 运行环境：Oracle 19c
• 执行操作：拔出名为TESTDB的PDB，执行SQL如下：

alter pluggable database TESTDB unplug into '/u01/app/orabackup/test.xml';

• 返回完整报错：

ORA-65026: XML metadata file error : LPX-00202: could not open "/u01/app/orabackup/test.xml" (error 0)
注：该错误常出现于挂载已拔出PDB的场景，但拔出操作触发该错误的核心逻辑一致，均为Oracle数据库进程无法正常访问指定路径的XML文件，和操作类型无关。

故障根因 #

拔出PDB时Oracle需要向指定路径写入PDB元数据XML文件，无法正常访问目标路径时就会抛出该错误，常见诱因有3种：

• 指定的目标目录/u01/app/orabackup不存在
• Oracle数据库运行对应的操作系统用户（默认为oracle用户）对目标目录无读写、执行权限
• 目标路径下已存在同名test.xml文件，且文件被锁定、或oracle用户无覆盖写入权限

处理步骤 #

1. 登录数据库所在服务器，切换至oracle用户，执行以下命令检查目标目录是否存在：

   ls -ld /u01/app/orabackup
   

   如果返回无该文件或目录的提示，先执行命令创建目录：

   mkdir -p /u01/app/orabackup
   

2. 目录存在的前提下，执行命令修正目录归属与权限，确保oracle用户可正常写入：

   chown oracle:oinstall /u01/app/orabackup
   chmod 755 /u01/app/orabackup
   

3. 检查目标目录下是否已存在同名test.xml文件：

   ls -l /u01/app/orabackup/test.xml
   

   如果文件存在，确认无留存价值后可直接删除，也可以修改拔出语句中的XML文件名，避免重名冲突，例如调整为：

   alter pluggable database TESTDB unplug into '/u01/app/orabackup/testdb_unplug.xml';
   

4. 以上操作完成后，重新执行PDB拔出语句即可。
   注意：尽量不要将元数据XML文件存放在Oracle审计日志、trace日志等系统自动生成文件的目录下，避免权限继承异常导致写入失败。

内容的提问来源于stack exchange，提问作者Manish Lama