Oracle的UTL_HTTP包发起HTTP请求偶发ORA-29273错误如何排查？

DevOps 小满

2026-10-5

首先你现有代码存在2个非常明显的语法错误，是触发概率性报错的核心诱因：

请求头拼写错误：你设置Content-Length的代码中，头名拼写为CONENT-LENGT，和标准头名Content-Length完全不符，会导致Tomcat无法正确识别请求体长度，部分场景下会等待后续数据直到超时，触发报错。
长度计算逻辑错误：你使用LENGTH(V_BODY)计算请求体长度，该函数返回的是字符数，如果请求体包含多字节字符（比如中文、emoji等），计算值会远小于实际字节数，同样会导致Tomcat读取请求体不完整。

其他可能触发概率性ORA-29273报错的原因：

资源未正确释放：现有代码没有异常捕获逻辑，请求失败时不会执行后续的连接释放方法，UTL_HTTP连接池耗尽后新请求就会失败，20%左右的失败概率符合连接资源耗尽的特征。
超时配置缺失：未设置请求传输超时，网络波动时请求阻塞超过Oracle默认超时阈值就会直接抛出异常。
请求体字符集不匹配：写入请求体时未显式指定字符集，和设置的响应字符集不统一，部分特殊字符会导致请求体损坏。

修正后的参考代码：

DECLARE
  REQ UTL_HTTP.REQ;
  RES UTL_HTTP.RESP;
  V_BODY CLOB := '你的请求体内容';
  BUFFER VARCHAR2(32767);
BEGIN
  REQ := UTL_HTTP.BEGIN_REQUEST(URL,'POST','HTTP/1.1');
  -- 设置30秒传输超时，按需调整
  UTL_HTTP.SET_TRANSFER_TIMEOUT(REQ, 30);
  UTL_HTTP.SET_HEADER(REQ,'User-Agent','MOZILLA/4.0');
  -- 修正头名拼写，用LENGTHB计算字节长度
  UTL_HTTP.SET_HEADER(REQ,'Content-Length',LENGTHB(V_BODY));
  UTL_HTTP.SET_HEADER(REQ,'Content-Type','application/json; charset=utf-8');
  UTL_HTTP.SET_HEADER(REQ,'SDATE','01/06/2021');
  -- 显式指定请求体字符集
  UTL_HTTP.SET_BODY_CHARSET(REQ, 'UTF-8');
  UTL_HTTP.WRITE_TEXT(REQ,V_BODY);
  RES:= UTL_HTTP.GET_RESPONSE(REQ);
  UTL_HTTP.SET_BODY_CHARSET(R => RES, CHARSET => 'UTF-8');
  UTL_HTTP.READ_TEXT(RES,BUFFER);
  -- 正常释放资源
  UTL_HTTP.END_RESPONSE(RES);
  UTL_HTTP.END_REQUEST(REQ);
EXCEPTION
  WHEN OTHERS THEN
    -- 异常场景也释放资源，避免连接泄漏
    IF RES.IS_OPEN THEN
      UTL_HTTP.END_RESPONSE(RES);
    END IF;
    IF REQ.IS_OPEN THEN
      UTL_HTTP.END_REQUEST(REQ);
    END IF;
    -- 可以在这里打印错误详情排查问题
    DBMS_OUTPUT.PUT_LINE('错误码：'||SQLCODE||' 错误信息：'||SQLERRM);
    RAISE;
END;
/

如果修改后还是有报错，可以捕获异常后打印完整的错误栈，ORA-29273是HTTP请求通用报错，通常后面会跟着更具体的二级错误码，比如ORA-12535是网络超时、ORA-29263是HTTP 404错误等，可以根据具体的二级错误码进一步定位问题。

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