SQL Server 存储过程调用外部Web API需启用Ole Automation Procedures，因其高风险被默认禁用；必须按序执行sp_configure开启高级选项和该功能，并RECONFIGURE生效；推荐使用MSXML2.ServerXMLHTTP，POST必须设Content-Type，且需组合检查返回值、HTTP状态码和sp_OAGetErrorInfo诊断失败。
SQL Server 存储过程能调用外部 Web API，但必须启用 Ole Automation Procedures，且仅限于同步、无事务保障的 HTTP 请求；这不是标准推荐路径，而是特定受限场景下的权宜之计。
为什么必须先开启 Ole Automation Procedures
SQL Server 默认禁用该功能，因为 sp_OACreate 等 OLE 自动化存储过程属于高风险组件，可能被用于执行任意 COM 对象。不开启就直接调用会报错：
Msg 15281, Level 16, State 1, Procedure sp_OACreate, Line 1 SQL Server blocked access to procedure 'sys.sp_OACreate' of component 'Ole Automation Procedures'...
开启需两步（必须按顺序）：
-
sp_configure 'show advanced options', 1→ 再RECONFIGURE -
sp_configure 'Ole Automation Procedures', 1→ 再RECONFIGURE
注意：RECONFIGURE 不是可选的——缺一次都会导致配置未生效；执行后建议运行 EXEC sp_configure 'Ole Automation Procedures' 确认值为 1 且 run_value 列也为 1。
sp_OACreate 支持哪些 ProgID？推荐用哪个
常见可用 ProgID 包括：
-
MSXML2.ServerXMLHTTP（最常用，支持 HTTPS、超时控制、自定义 Header） -
Msxml2.ServerXMLHTTP.3.0（向后兼容旧版本，行为更稳定） -
WinHttp.WinHttpRequest.5.1（更轻量，但部分 SQL Server 版本需额外注册）
不推荐用 XMLHTTP 或 Microsoft.XMLHTTP：它们是客户端类，不支持服务端同步阻塞调用，容易在连接池或重定向时失败。实际使用中优先选 MSXML2.ServerXMLHTTP，它对 POST + application/json 的支持最可靠。
POST 请求必须设置 Content-Type 吗
必须。否则目标 API 很可能返回 415 Unsupported Media Type 或静默忽略请求体。
不同数据格式对应不同写法：
- JSON：用
EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'application/json' - 表单编码：
'application/x-www-form-urlencoded'，且@body必须是 URL 编码字符串（如name=%E5%BC%A0%E4%B8%89&id=123） - 纯文本：
'text/plain'，但极少用
漏掉 setRequestHeader 是调试阶段最常见的失败原因——sp_OAMethod 调用无返回值，错误不会抛出，只能靠后续 responseText 或 sp_OAGetErrorInfo 检查。
如何捕获和诊断请求失败
不能只依赖 @resp 返回值判断成功——sp_OACreate 成功只代表对象创建了，不代表网络请求成功。
必须组合使用三类检查：
- 检查
sp_OACreate返回值是否为0（非零即失败） - 调用
sp_OAMethod @obj, 'status', @status OUTPUT获取 HTTP 状态码（需在send后立即调用） - 始终加
EXEC sp_OAGetErrorInfo @obj，它会在出错时返回@source和@desc，比如"The server name or address could not be resolved"
还要记得 EXEC sp_OADestroy @obj：不释放会导致句柄泄漏，多次执行后可能触发 OLE object was not released 错误。
真正棘手的是超时和事务耦合——OLE 调用是同步阻塞的，若 API 响应慢，会拖住整个存储过程甚至阻塞事务，而 SQL Server 不提供原生超时参数（MSXML2.ServerXMLHTTP 的 setTimeouts 方法在某些版本上不可靠）。生产环境务必加外围监控和降级逻辑，别把它当常规通信手段用。
