Oracle PL/SQL UTL_HTTP首次调用报ORA-29273/ORA-29259后续正常问题

• 首次连接的SSL握手/钱包初始化延迟：UTL_HTTP首次调用set_wallet时，Oracle需要加载并验证钱包文件，这个过程存在的延迟会导致后续请求发送操作（比如write_text）在连接完全建立前就执行，引发请求数据未完整发送、服务端提前关闭连接的情况，最终触发ORA-29259异常。后续调用时钱包已加载到内存，无需重复初始化，请求就能正常执行。
• HTTP连接复用的影响：首次调用时连接未被复用，需要重新建立完整的SSL会话；而后续调用复用了已建立的连接，避开了初始化开销，因此无异常。

1. 提前初始化钱包 #

在会话启动时预先加载钱包，避免首次调用时的初始化延迟。可以执行一次空的UTL_HTTP请求来完成钱包初始化：

-- 会话初始化时执行
begin
  utl_http.set_wallet('file:/wallet_path', 'password');
  -- 发送简单HEAD请求完成初始化
  declare
    req utl_http.req;
    resp utl_http.resp;
  begin
    req := utl_http.begin_request('https://your-target-url.com', 'HEAD');
    resp := utl_http.get_response(req);
    utl_http.end_response(resp);
    utl_http.end_request(req);
  exception
    when others then
      if utl_http.is_response_open(resp) then
        utl_http.end_response(resp);
      end if;
      if utl_http.is_request_open(req) then
        utl_http.end_request(req);
      end if;
  end;
end;
/

2. 优化函数内的资源处理逻辑 #

调整函数内的资源释放顺序，增加对请求/响应状态的判断，避免异常时的二次错误；同时优化钱包初始化逻辑，增加短暂延迟确保加载完成：

create or replace function send_post_request (p_url           in varchar2,
                                p_content       in clob default null)
        return clob
    is
        v_url      varchar2 (255);
        req        utl_http.req;
        resp       utl_http.resp;
        buffer     varchar2 (32767);
        response   clob;
    begin
         v_url := p_url;

        utl_http.set_wallet (
            'file:/wallet_path',
            'password');
        -- 增加短暂延迟确保钱包加载完成
        dbms_lock.sleep(0.5);
        
        utl_http.set_transfer_timeout (300);
        utl_http.set_persistent_conn_support(true); -- 启用连接复用
        req :=
            utl_http.begin_request (v_url, 'post', utl_http.http_version_1_1);
        utl_http.set_authentication (req, '<hidden>', '<hidden>');

        utl_http.set_header (req, 'user-agent', 'mozilla/4.0');
        utl_http.set_header (req, 'content-type', 'application/json');

        if p_content is not null
        then
            utl_http.set_body_charset ('utf-8');
            -- 修正Content-Length计算方式
            utl_http.set_header (req,
                                 'content-length',
                                 dbms_lob.getlength(p_content));
            utl_http.write_text (req, p_content);
        end if;

        resp := utl_http.get_response (req);

        utl_http.set_body_charset (r => resp, charset => 'utf-8');

        if resp.status_code != utl_http.http_ok
        then
            raise_application_error (
                -20001,
                'response status code: ' || resp.status_code);
        end if;

        begin
            loop
                utl_http.read_text (resp, buffer);
                response := response || buffer;
            end loop;
        exception
            when utl_http.end_of_body
            then
                null;
        end;

        -- 先结束响应再结束请求，符合UTL_HTTP规范
        utl_http.end_response (resp);
        utl_http.end_request (req);

        return response;
    exception
        when others
        then
            -- 确保资源安全释放
            if utl_http.is_response_open(resp) then
                utl_http.end_response (resp);
            end if;
            if utl_http.is_request_open(req) then
                utl_http.end_request (req);
            end if;
            raise_application_error (
                -20002,
                sqlerrm || ' / ' || utl_http.get_detailed_sqlerrm);
    end;
/

3. 启用HTTP连接复用 #

通过utl_http.set_persistent_conn_support(true)启用连接复用，让后续请求复用首次建立的连接，减少重复初始化的开销。

4. 修正Content-Length计算 #

原代码中lengthb(to_char(p_content))在处理多字节字符时可能存在误差，改用dbms_lob.getlength(p_content)直接获取CLOB的字节长度，确保Content-Length头准确。

• 重启会话后首次调用修改后的函数，检查是否仍抛出异常；
• 多次调用函数，确认所有请求均能正常返回结果；
• 监控函数执行时间，确认首次调用的性能无明显下降。

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