如何在PL/SQL中解析Oracle CLOB获取完整API错误信息？

核心问题1：DBMS_LOB.SUBSTR参数顺序错误 #

你的代码中sys.dbms_lob.substr(l_resp, 1, 531)的参数顺序完全搞反了。DBMS_LOB.SUBSTR的正确语法是：

DBMS_LOB.SUBSTR (
   lob_loc     IN    CLOB/BLOB,
   amount      IN    INTEGER := 32767,
   offset      IN    INTEGER := 1
) RETURN VARCHAR2;

你写的(l_resp, 1, 531)表示从第531位开始，仅截取1个字符，这直接导致错误响应内容被截断为空或单个字符，所以错误信息里只有400-后面没有实质内容。

核心问题2：RAISE_APPLICATION_ERROR的消息长度限制 #

Oracle的raise_application_error抛出的自定义错误（ORA-20000至ORA-20999），错误消息的最大长度为2048字节。如果API返回的错误响应超过这个长度，即便参数顺序正确，消息也会被自动截断。

修复步骤 #

步骤1：修正DBMS_LOB.SUBSTR参数顺序 #

把错误的截取代码改成正确顺序，比如截取前2000个字符（预留空间给前缀文本）：

raise_application_error(-20001, 'API Error2: '
                                || apex_web_service.g_status_code
                                || '-'
                                || sys.dbms_lob.substr(l_resp, 2000, 1)); -- 正确顺序：LOB对象、截取长度、起始位置

步骤2：处理超长错误响应（可选但推荐） #

如果API返回的错误内容超过2048字节，建议用以下方式留存完整信息：

1. 将完整错误写入日志表：创建一个错误日志表，存储请求URL、请求体、响应体、状态码等信息，方便后续排查。
   示例表结构：

   CREATE TABLE api_error_logs (
       log_id NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
       request_url VARCHAR2(1000),
       request_body CLOB,
       response_body CLOB,
       status_code NUMBER,
       error_timestamp TIMESTAMP DEFAULT SYSTIMESTAMP
   );
   

   在错误分支中插入日志：

   IF apex_web_service.g_status_code >= 400 THEN
       -- 插入完整错误日志到表
       INSERT INTO api_error_logs (request_url, request_body, response_body, status_code)
       VALUES (g_fusion_url, p_body, l_resp, apex_web_service.g_status_code);
       COMMIT;
   
       -- 抛出包含日志ID的错误，方便定位
       raise_application_error(-20001, 'API Error2: '
                                       || apex_web_service.g_status_code
                                       || ' - 完整错误信息请查看API_ERROR_LOGS表，LOG_ID: '
                                       || api_error_logs_seq.CURRVAL); -- 若用序列生成ID，替换为对应序列名
   END IF;
   

2. 使用APEX_DEBUG记录完整内容：如果在APEX环境中运行，可用apex_debug.log_clob记录完整响应CLOB，再在错误消息中提示查看调试日志：

   IF apex_web_service.g_status_code >= 400 THEN
       apex_debug.log_clob('API Error Response', l_resp);
       raise_application_error(-20001, 'API Error2: '
                                       || apex_web_service.g_status_code
                                       || ' - 完整错误信息请查看APEX调试日志');
   END IF;
   

验证修复 #

修正参数顺序后，重新调用API，错误消息会包含正确截取的响应内容；如果用日志表方案，直接查询表就能获取和SOAPUI/POSTMAN中一致的完整错误响应。

内容的提问来源于stack exchange，提问作者virtual transfer