OPatch版本不匹配是补丁失败主因,须按MOS 274526.1查最低要求并覆盖升级,重设PATH;inventory路径三者必须一致;RU与PSU基线不可混装;opatch auto失败需查日志、清理锁并手动修复。

opatch version 报错或显示版本过低
OPatch 版本不匹配是补丁失败最常见原因,尤其在 19c 及以后版本中,opatch lsinventory 都可能直接报错退出。根本问题不是“没装好”,而是当前 $ORACLE_HOME/OPatch 下的工具太老,解析不了新补丁的元数据(比如 RU 补丁要求最低 12.2.0.1.32,而你用的是 12.2.0.1.10)。
必须按 MOS 文档 Document ID 274526.1 查你数据库版本对应的最低 OPatch 要求,不能凭经验猜。例如 19c 2026 年最新 RU 要求至少 12.2.0.1.45;EPM 系统则需单独查 EPM 版本兼容表。
- 先确认路径:
cd $ORACLE_HOME/OPatch && ./opatch version - 下载地址固定为
https://updates.oracle.com/download/6880880.html,选对平台(Linux-x86-64 / Windows 等)和目标版本号 - 解压后直接覆盖原目录:
unzip -o p6880880_1220145_Linux-x86-64.zip -d $ORACLE_HOME(-o强制覆盖) - 立刻重设 PATH:
export PATH=$ORACLE_HOME/OPatch:$PATH,否则 shell 可能仍调用/usr/bin/opatch或旧路径缓存
opatch lsinventory 报 “invalid inventory location” 或 “OracleHomeInventory gets null oracleHomeInfo”
这通常不是权限问题,而是 OPatch 与 Oracle Inventory 之间“认不出彼此”。旧版 OPatch 读取不到新版 inventory.xml 结构,或 inventory 路径注册错位,导致 oracleHomeInfo 为空。
别急着 chmod 或 chown,先验证三者是否一致:
-
$ORACLE_HOME环境变量必须是绝对路径,不能含~或./(opatch报 error code 1 就是这个原因) -
/etc/oraInst.loc中的 inventory 路径要真实存在,且该路径下有ContentsXML/inventory.xml -
inventory.xml内的<home name="xxx" loc="/u01/app/oracle/product/19c/dbhome_1">必须与当前$ORACLE_HOME完全一致(包括末尾斜杠、大小写) - RAC 环境下,所有节点的
oraInst.loc和 inventory 内容必须同步,不能只更新一个节点
若 inventory 损坏,用 runInstaller -ignoreSysPrereqs -force -silent -attachHome ORACLE_HOME=$ORACLE_HOME 修复,而非手动编辑 XML。
打 RU 补丁时提示 “This patch is not applicable for this environment”
这不是 OPatch 版本问题,而是基线类型冲突。从 12.2 开始,PSU 和 RU 是两条互斥主线:RU 补丁只能打在 RU 基线上,PSU 补丁只能打在 PSU 基线上。混装会直接被拒绝,不进冲突检测环节。
判断当前基线类型,不要看补丁名,要看实际安装记录:
-
opatch lsinventory | grep -i "release update"—— 若有输出,说明已是 RU 基线 -
opatch lsinventory | grep -i "patch set update"—— 若有输出,说明是 PSU 基线 - RU 补丁包名形如
p37260974_190000_Linux-x86-64.zip,PSU 则无Release Update字样 - 若当前是 PSU,想升 RU,必须先用对应 RU 的完整包(如
p37260974)执行opatch auto,不能只打单个 RU 补丁
强行跳过检查(如加 -skip_subset)会导致 datapatch 失败、字典不一致,后续无法启动实例。
opatch auto 执行一半失败后反复卡住
opatch auto 不是原子操作,它只是顺序调用 stop → opatch apply → datapatch → start。任一环节失败(尤其是 datapatch 执行 SQL 报错),它不会回滚已做的变更,inventory 会被锁住,再次运行会卡在同一点。
遇到失败,第一反应不是重试,而是看日志定位断点:
- 主日志路径:
$ORACLE_HOME/cfgtoollogs/opatchauto/opatchauto2026-07-21_11-34-00.log - 重点关注
datapatch部分:是否有ORA-01031: insufficient privileges或ORA-00942: table or view does not exist - 若卡在 datapatch,先手动连库执行:
sqlplus / as sysdba @?/rdbms/admin/catbundle.sql psu apply(根据补丁类型换ru) - 清理锁:
rm -f $ORACLE_HOME/.patch_storage/*.lock,再运行opatch rollback -id <failed_patch_id>(如有已部分应用的补丁)
最易被忽略的是:RAC 环境下,opatch auto 必须在所有节点同时执行,且每个节点都要单独跑一遍 root.sh,漏掉任意一个节点都会导致 inventory 状态不一致,后续所有操作都不可信。


















