UTL_HTTP调用总失败的主因是四层校验缺失：ACL权限未配（ORA-24247）、HTTPS未配置Wallet导致证书验证失败（ORA-29024）、字符集与响应读取方式错误、method/charset/Content-Length等参数设置不当。
UTL_HTTP 是 Oracle 里调用 HTTP 接口的唯一原生方案，不依赖 Java 或外部工具。但直接用它容易出错——不是返回空、超时，就是权限报错 ORA-29273: HTTP request failed，甚至根本连不上。
为什么 UTL_HTTP 调用总失败？先查 ACL 权限
Oracle 11g 之后强制网络访问控制（ACL），没配 ACL 就算代码全对也会报 ORA-24247: network access denied by access control list (ACL)。
检查和配置分三步：
- 查当前用户是否有 connect 权限：
SELECT * FROM dba_network_acl_privileges WHERE principal = 'YOUR_USER'; - 查 ACL 是否已分配给目标主机：
SELECT host, lower_port, upper_port FROM dba_network_acl_entries WHERE acl LIKE '%utl_http%'; - 若无 ACL 或权限不足，需 DBA 执行（或你有
DBA角色）：BEGIN DBMS_NETWORK_ACL_ADMIN.CREATE_ACL( acl => '/sys/acls/utl_http.xml', description => 'HTTP access for UTL_HTTP', principal => 'YOUR_USER', is_grant => TRUE, privilege => 'connect'); DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL( acl => '/sys/acls/utl_http.xml', host => '*', lower_port => 1, upper_port => 65535); END;注意：host 设为'*'表示允许所有域名；生产环境建议精确到'api.example.com'。UTL_HTTP.BEGIN_REQUEST的 method 和 charset 容易写错GET 请求最简方式是
UTL_HTTP.REQUEST(url)，但它只支持 GET、返回VARCHAR2、且长度上限 2000 字节（实际常截断）。真要可控，必须用BEGIN_REQUEST+GET_RESPONSE流式读取。常见错误点：
-
UTL_HTTP.SET_BODY_CHARSET('UTF-8')必须在BEGIN_REQUEST之后、SET_HEADER之前调用，否则 POST 时中文变乱码 - POST 请求必须显式设
Content-Length，且值是字节长度（不是字符数）：LENGTHB(p_data)，不是LENGTH(p_data) -
Content-Type值要匹配实际 payload：application/json就不能写成application/x-www-form-urlencoded - GET 参数拼接进 URL 后，整个 URL 需 URL 编码（Oracle 不自动编码），否则空格、中文会 400
读取响应时别只用
READ_LINEUTL_HTTP.READ_LINE只读一行，遇到大响应或二进制内容（如图片、PDF）会崩溃或丢数据。正确做法是循环READ_RAW并转CLOB：DECLARE req UTL_HTTP.REQ; resp UTL_HTTP.RESP; buf RAW(32767); clob_out CLOB; BEGIN req := UTL_HTTP.BEGIN_REQUEST('https://httpbin.org/get'); resp := UTL_HTTP.GET_RESPONSE(req); DBMS_LOB.CREATETEMPORARY(clob_out, TRUE); BEGIN LOOP UTL_HTTP.READ_RAW(resp, buf, 32767); DBMS_LOB.WRITEAPPEND(clob_out, UTL_RAW.LENGTH(buf), UTL_RAW.CAST_TO_VARCHAR2(buf)); END LOOP; EXCEPTION WHEN UTL_HTTP.END_OF_BODY THEN NULL; END; UTL_HTTP.END_RESPONSE(resp); DBMS_OUTPUT.PUT_LINE(DBMS_LOB.SUBSTR(clob_out, 200, 1)); DBMS_LOB.FREETEMPORARY(clob_out); END;注意：
READ_RAW比READ_TEXT更安全，避免字符集转换错误；CLOB才能容纳完整响应（最大 4GB）。HTTPS 请求必须配 Oracle Wallet
用
https://时，UTL_HTTP默认要求 Oracle Wallet 包含可信 CA 证书。没配就会报ORA-29273: HTTP request failed+ORA-29024: Certificate validation failure。解决路径只有两条：
- 临时绕过验证（仅测试用）：
UTL_HTTP.SET_WALLET('');—— 但 Oracle 12cR2+ 已禁用空 wallet，必须用UTL_HTTP.SET_TRANSFER_TIMEOUT(60)+UTL_HTTP.SET_FOLLOW_REDIRECT(FALSE)辅助定位问题 - 正式环境必须创建 wallet：
orapki wallet create -wallet /path/to/wallet -auto_login orapki wallet add -wallet /path/to/wallet -dn "CN=*.example.com" -trusted_cert -cert /path/to/cert.pem
然后在 PL/SQL 中：UTL_HTTP.SET_WALLET('file:/path/to/wallet', 'wallet_password');
Wallet 路径必须数据库服务器本地可读，且 Oracle 进程有权限访问文件系统目录。
真正麻烦的从来不是怎么写请求，而是权限、字符集、响应体类型、SSL 信任链这四层嵌套校验。漏掉任意一层，
UTL_HTTP就静默失败或返回不可靠结果。 -
