PHP纯异步WSDL回调接口接收XML响应的实现问题咨询

各问题对应解决方法 #

1. GET请求的头信息与XML正文捕获 #

PHP默认只会自动解析POST请求的请求体，且$_SERVER里存储的头信息存在字段裁剪、遗漏的问题，按下面的方式拿全量数据即可：

• 全量请求头直接调用getallheaders()获取，Apache、FPM环境下原生支持，若你用Nginx+自定义PHP运行环境找不到该函数，遍历$_SERVER中所有HTTP_开头的键，去掉前缀、下划线转横杠、首字母大写拼接即可拿到完整头。
• 原始请求正文不管请求方法是GET还是POST，直接读取php://input原生流就能拿到，不要依赖$_POST，该超全局变量仅会解析application/x-www-form-urlencoded格式的POST请求，完全无法识别XML格式正文。

参考代码：

// 获取全量请求头
$requestHeaders = getallheaders();
// 获取原始请求XML内容
$rawRequestBody = file_get_contents('php://input');
// 调试阶段强制打日志，存头和原始内容方便排查
file_put_contents(
    __DIR__ . '/soap_callback_debug.log',
    sprintf("[%s] Headers: %s\nBody: %s\n\n", date('Y-m-d H:i:s'), json_encode($requestHeaders), $rawRequestBody),
    FILE_APPEND
);

对方authorization头为空是正常情况，既然对方明确走IP白名单鉴权，你只需要在回调入口先校验请求来源IP是否在对方提供的白名单网段内即可，无需纠结鉴权头内容。

2. 异步SOAP请求方法的规范问题 #

标准SOAP 1.1/1.2规范明确要求，携带SOAP信封的业务请求必须使用POST方法传输：SOAP1.1要求Content-Type为text/xml，SOAP1.2要求为application/soap+xml；GET方法仅用于WSDL文件拉取、无正文的简单查询类请求，不可能用来传输XML格式的SOAP正文。
你目前收到的GET请求无content-length、无正文，属于对方配置错误，大概率是回调路由配置、请求方法枚举写错，直接把你抓到的GET请求日志发给对方技术支持排查即可，不需要在自己侧兼容逻辑。

3. 纯被动异步接收逻辑实现 #

这套逻辑和你之前写的同步cURL请求逻辑完全独立，不需要保留进程等待响应，按以下步骤落地：

• 先按照对方文档给出的规范，部署你自己的WSDL文件，Target Namespace、Port name、Service name三个字段必须和文档完全一致，WSDL文件放在回调域名的可访问路径下，确保对方能通过443（优先）、80、8443、8080这几个合规端口正常拉取。
• 编写回调入口处理逻辑：
  • 第一步：校验来源IP，不在白名单内的请求直接返回403状态码
  • 第二步：按前面给出的方法获取全量请求头、原始请求体，先写日志存底，避免后续对账无凭证
  • 第三步：用simplexml_load_string()或者DOMDocument解析拿到的XML正文，提取业务字段后走你自己的业务处理逻辑（更新单据状态、存储处理结果等）
  • 第四步：按照对方文档要求的XML结构组装返回响应，设置正确的Content-Type: text/xml头后输出内容即可
• 注意回调入口不要加登录鉴权、人机验证、CC拦截规则，不要做非预期的跳转，避免对方请求被拦截。

落地注意事项 #

• 你之前写的cURL请求逻辑，拿到对方返回的pending状态后直接结束进程即可，不要做长连接等待，最长2小时的回调周期会占满PHP-FPM进程，直接导致服务不可用。
• 回调接口必须做幂等处理：同一业务单号/请求ID如果被对方重复推送，直接返回成功响应，不要重复执行业务逻辑，避免出现重复更新状态、重复入账的问题。
• 如果对方坚持声称用GET传输XML，直接把Web服务器（Nginx/Apache）的访问日志发给对方，GET请求的日志中body字节数固定为0，不存在携带XML正文的可能，无需扯皮。

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