Oracle Python驱动oracledb中CLOB处理异常导致连接状态损坏问题分析

Oracle Python驱动oracledb中CLOB处理异常导致连接状态损坏问题分析

问题描述

在使用oracledb 2.1.2版本连接Oracle数据库(19c/23c)时，开发人员发现了一个严重的问题：当执行一个返回CLOB的自定义函数并触发异常后，后续的查询操作会导致连接进入损坏状态。

具体表现为：当调用一个返回JSON格式CLOB的PL/SQL函数时，如果函数内部抛出异常(如参数校验失败)，即使捕获了这个异常，后续使用相同连接执行其他查询也会失败，报出"DPY-5002: internal error: read integer of length 40 when expecting integer of no more than length 4"这样的内部错误。

问题复现

要复现这个问题，需要创建一个简单的PL/SQL函数：

CREATE OR REPLACE FUNCTION MYFUNC
(
  PARAM1 IN NUMBER 
) RETURN CLOB AS 
outval CLOB;
BEGIN
  IF PARAM1 <  THEN
    RAISE_APPLICATION_ERROR(-20000,'Test');
  END IF;
  SELECT JSON_OBJECT('A' VALUE 1) INTO outval FROM DUAL;
  RETURN outval;
END MYFUNC;

然后在Python中执行以下代码：

import oracledb
conn = oracledb.connect(user="login", password="password", 
                       host="host", port=1521, service_name="service_name")

# 第一次执行会触发异常
with conn.cursor() as cursor:
    try:
        cursor.execute("SELECT MYFUNC(:id) FROM DUAL", {"id": -1})
        results = cursor.fetchone()
    except oracledb.DatabaseError as e:
        print(str(e))  # 正常捕获异常

# 第二次执行应该成功但实际失败
with conn.cursor() as cursor2:
    cursor2.execute("SELECT MYFUNC(:id) FROM DUAL", {"id": 2})
    results = cursor2.fetchone()  # 这里抛出内部错误

问题分析

经过深入分析，这个问题与CLOB数据类型和JSON_OBJECT函数的特殊处理有关。当PL/SQL函数抛出异常时，驱动在清理资源时没有正确处理CLOB相关的缓冲区状态，导致连接处于不一致的状态。

关键发现点：

1. 只有当函数返回CLOB类型时才会出现此问题
2. 使用JSON_OBJECT函数生成CLOB时问题更易复现
3. 如果使用json_serialize转换输出或直接返回字符串拼接的CLOB，问题不会出现

这表明问题与驱动对特定类型CLOB数据的异常处理流程有关。

解决方案

oracledb开发团队已经确认这是一个bug，并在2.2.1版本中修复了这个问题。修复的核心是正确处理异常情况下CLOB资源的清理工作。

对于无法立即升级的用户，可以采取以下临时解决方案：

1. 在捕获异常后显式关闭并重新建立连接
2. 修改PL/SQL函数，避免直接返回JSON_OBJECT生成的CLOB
3. 在查询中使用json_serialize转换输出

最佳实践建议

1. 对于关键业务系统，建议尽快升级到oracledb 2.2.1或更高版本
2. 在处理CLOB等大对象时，确保有完善的异常处理机制
3. 考虑使用连接池管理连接，在异常情况下自动获取新连接
4. 对于返回JSON的PL/SQL函数，可以考虑使用VARCHAR2而非CLOB，或确保有统一的异常处理

这个问题提醒我们，在使用数据库驱动处理特殊数据类型时，需要特别注意异常情况下的资源清理和状态管理。