Oracle数据库 ORA-00162 错误分析和解决

好的，我们来详细解析 ORA-00162 错误。这个错误与 ORA-00160 和 ORA-00161 同属一个系列，完成了对 X/Open XA 事务标识符 (XID) 三个组成部分的完整性检查。

ORA-00162: 外部全局事务 ID 的格式 ID 非法

1. 错误信息结构组成说明

一个典型的 ORA-00162 错误信息格式如下：

ORA-00162: illegal format id for external global transaction id

• 错误代码 (Error Code): ORA-00162
• 错误消息 (Error Message): illegal format id for external global transaction id
• 参数 (Parameters): 此错误消息通常不包含动态参数，是一个静态的声明。

这个结构直接指明了问题的核心：提供了一个不被Oracle数据库接受的、非法的格式标识符（Format ID），用于外部全局事务ID。

2. 官方正式说明

原因 (Cause)

根据Oracle官方文档，此错误的发生是由于：

尝试启动或恢复一个分布式事务时，为其指定的格式标识符（Format ID）是一个不被当前Oracle数据库版本或配置所支持的非法值。

在X/Open XA标准中，全局事务标识符（XID）由三个部分组成：

1. formatID: 一个整数值，用于定义后续 gtrid 和 bqual 字段的格式和解释方式。它本质上是一个“协议版本号”。
2. gtrid (Global Transaction Identifier): 全局事务标识符（字节串）。
3. bqual (Branch Qualifier): 分支限定符（字节串）。

formatID 告诉事务管理器如何解析 gtrid 和 bqual。Oracle数据库有其预期和支持的 formatID 值。当应用程序（通常是XA接口库、事务监视器或中间件）尝试使用一个Oracle无法识别的 formatID 时，就会引发ORA-00162错误。

场景 (Scenarios)

1. 编程错误： 开发人员在使用Oracle XA库（如 xa_start, xa_open）进行编程时，手动将 formatID 参数设置为了一个任意值（如一个随机数或不支持的负数），而不是使用Oracle期望的标准值。
2. 中间件/驱动不兼容： 使用一个版本过旧或配置错误的应用程序服务器（如WebLogic、WebSphere）、事务监视器（如Tuxedo）或数据库驱动（如较老的JDBC驱动）。该中间件可能使用了一个过时的、废弃的或者Oracle当前版本不再支持的 formatID。
3. 跨异构系统的事务： 在极其复杂的异构环境中，尝试协调一个涉及Oracle和非Oracle系统（如IBM CICS、Microsoft DTC）的分布式事务。如果这些系统使用的默认 formatID 不兼容，可能在Oracle端触发此错误。
4. 恢复过程： 在事务恢复期间，事务管理器尝试恢复一个之前挂起的事务，但该事务的 formatID 信息因某种原因损坏或无法识别。

相关原理 (Related Principles)

• X/Open XA 标准: 定义了分布式事务处理(DTP)的模型和接口。formatID 是XID结构的一部分，旨在提供扩展性，允许不同的厂商或场景定义自己的格式。
• Oracle的FormatID约定: 虽然XA标准允许使用不同的 formatID，但Oracle数据库内部对其有特定的期望。通常，Oracle期望使用一个特定的正值（在不同的Oracle版本中，常见的值如 0x4E41 (‘NA’) 或其他Oracle内部值）。使用 0 也是一个常见的、被广泛支持的选择。
• 事务管理器角色: 事务管理器（TM）是负责分配和解释XID的组件。应用程序或资源管理器（RM）通常不应随意发明 formatID，而应使用其事务管理器提供的值。

相关联的其他ORA-错误

• ORA-00160: 全局事务名长度超出限制（gtrid过长）。
• ORA-00161: 事务分支的分支限定符长度非法（bqual过长）。
• ORA-00155: 无法在全局事务外执行工作。
• ORA-24776: 无法开始新事务。可能与错误的事务状态有关。
• ORA-02054: 事务处理中发生错误。ORA-00162可能作为其底层原因出现。

3. 定位原因与分析过程

1. 识别触发点： 确定错误是在哪个应用程序、哪个中间件、执行什么操作时发生的。是启动事务时，还是恢复事务时？
2. 审查代码和配置（首要任务）：
   • 对于自定义程序： 检查所有调用XA接口（如 xa_start）的代码。确认 formatID 参数的值是多少。它应该是一个被Oracle支持的值（通常是 0 或由Oracle TM提供的值）。
   • 对于中间件： 这是最常见的原因。检查中间件的XA数据源配置、事务管理器配置。查阅中间件的官方文档，了解其与Oracle交互时使用的 formatID 规范。检查中间件和Oracle数据库驱动的版本兼容性矩阵。
3. 启用跟踪： 如果问题复杂，可以在Oracle端启用SQL跟踪或诊断事件，以捕获完整的XA调用信息，从而看到引发错误的无效 formatID 的具体值。
4. 检查环境： 确认是否存在异构事务系统集成，并检查这些系统的配置。

4. 解决方案与相关SQL

解决方案

1. 修正formatID值（根本解决方案）：

   • 对于自定义程序： 将代码中硬编码的 formatID 值修改为Oracle支持的值。最安全、最通用的做法是使用 0，或者在Oracle提供的XA示例代码中查找正确的值。
   • 对于中间件： 这是主战场。
     • 升级/打补丁： 将中间件和Oracle驱动升级到兼容的版本。这通常是解决因版本不匹配导致的 formatID 问题的最佳方法。
     • 修改配置： 仔细检查中间件的XA相关配置。某些中间件允许在数据源配置中指定事务属性或XID相关的设置。将其重置为默认值或根据文档配置为与Oracle兼容的值。
     • 联系供应商支持： 如果无法确定，联系中间件供应商的支持，询问关于与Oracle数据库交互时 formatID 的兼容性问题。

2. 审查异构集成方案： 如果涉及非Oracle系统，需要确保所有系统就XID的格式（包括 formatID）达成一致。可能需要使用一个双方都支持的公共事务管理器。

相关SQL语句

这个错误发生在事务开始阶段，与SQL操作无关，因此没有直接解决该问题的SQL语句。SQL主要用于诊断和查看事务状态。

• 查询当前未决的分布式事务（需要DBA权限）：

  SELECT LOCAL_TRAN_ID, GLOBAL_TRAN_ID, STATE, MIXED, HOST, COMMIT#
  FROM DBA_2PC_PENDING;
  

  这里的 GLOBAL_TRAN_ID 字段包含了格式化的XID信息，但可能无法直接读出原始的 formatID 数字。

• 强制提交或回滚一个挂起的分布式事务（如果错误导致事务挂起）：

  -- 需要知道 LOCAL_TRAN_ID
  EXECUTE DBMS_TRANSACTION.PURGE_LOST_DB_ENTRY('&local_tran_id');
  -- 或者使用
  EXECUTE DBMS_TRANSACTION.COMMIT_FORCE('&local_tran_id');
  EXECUTE DBMS_TRANSACTION.ROLLBACK_FORCE('&local_tran_id');
  

5. 通俗易懂的语言讲解

让我们继续使用跨国快递的比喻，这次我们关注“协议”本身：

想象一下Oracle的分布式事务系统是一个庞大的全球快递网络。

• 全局事务ID (XID)： 是整个快递包裹的完整运单。
• gtrid (总单号) 和 bqual (子单号)： 是运单上写的收件人、物品信息等内容。ORA-00160和00161是这些内容写得太长。
• formatID (格式标识符)： 是这份运单所遵循的国际快递协议版本号和语言编码。例如，它规定了运单是遵循《2024年国际快递协议v3.1中文版》来书写的。ORA-00162错误就是这个“协议版本号”填错了。

ORA-00162错误就像是：
你拿着一份运单去一个Oracle快递网点寄包裹。你的运单左上角印着“协议版本：银河系联邦快递标准v99.0”。网点工作人员拿到单子一看就懵了，说：“对不起先生，我们地球快递联盟从来没听说过v99.0这个协议（ORA-00162: illegal format id for external global transaction id），我们只支持到v3.1。您这单子我们处理不了。”

谁会拿错协议版本？

1. 自己填单写错了（编程错误）： 程序员在代码里瞎写了一个数字（比如 formatID = 12345）当成协议版本。
2. 用了过时的/错误的打印软件（中间件不兼容）： 你用的快递下单软件（中间件）版本太老，它还在用1998年的协议版本（v1.0），而现在的Oracle快递网点已经升级不支持了。或者软件有bug，生成了一个错误的版本号。

怎么解决？

1. 自己填单就改回来（修改代码）： 别自己发明协议版本号。使用一个公认的、标准的版本号，比如就写 0 ，这通常表示“使用当前环境的标准协议”。
2. 更新你的打印软件（升级/配置中间件）： 这是最可能的方法。把你用的快递软件（WebLogic等中间件）更新到最新版本，或者按照软件说明书，把它配置成使用和Oracle网点兼容的“协议版本号”。
3. 求助软件客服（联系供应商）： 如果你不知道该怎么配置，就打电话问给你提供快递软件的公司：“你们这个软件和Oracle一起用时，应该用哪个协议版本号啊？”

总而言之，ORA-00162是一个“协议不匹配”的错误。它告诉你：你的事务标识符所使用的格式版本（formatID）不被数据库认可。解决方法就是确保你的应用程序或中间件使用一个Oracle数据库支持和期望的formatID值，这通常通过升级驱动、修改配置或更正代码来实现。

欢迎关注我的公众号《IT小Chen》