ThinkPHP微信支付怎么接_ThinkPHP支付接口对接介绍【教程】-ThinkPHP-PHP中文网

thinkphp 接微信支付失败主因是签名逻辑、回调验签、目录配置三处未按2026年规则执行；常见问题包括total_fee未转整数、out_trade_no非法、spbill_create_ip不真实、签名未按字典序拼接、prepay_id后端签名缺失、notify_url无法解析xml、授权目录路径不匹配等。

thinkphp微信支付怎么接_thinkphp支付接口对接介绍【教程】

ThinkPHP 接微信支付不是「配个 config 就能跑」，关键卡点在签名逻辑、回调验签、目录配置三处。不按微信当前（2026年）实际规则走，90% 的失败都出在这三个地方。

统一下单接口返回 `INVALID_ARGUMENT` 或空数组

这是最常遇到的报错，本质是参数校验没过，但微信不告诉你具体哪条错。常见原因有：

total_fee 没转成整数分 —— 即使传 "100" 字符串也会失败，必须是 100（无引号）
out_trade_no 含非法字符或超长（最大32位，只支持数字、字母、下划线、中划线）
spbill_create_ip 是 "127.0.0.1" 或空 —— 必须是真实客户端出口 IP，本地调试建议用 $_SERVER['REMOTE_ADDR'] 且确保 Nginx/Apache 透传了真实 IP
未按字典序拼接签名字符串，或签名时漏了 key —— 微信仍强制要求 MD5 签名（非 HMAC-SHA256），哪怕你用了 APIv3 密钥

`getPrePayOrder()` 返回了 `prepay_id`，但前端调不起支付

后端拿到 prepay_id 只是第一步，前端真正拉起支付需要二次签名后的完整参数包。容易忽略的点：

微信公众号文章阅读器

读取并提取微信公众号文章标题、公众号名称及正文内容，支持移动端访问和自动重定向，适用于mp.weixin.qq.com链接。

下载

timestamp 必须是当前秒级时间戳（time()），不能缓存或复用旧值，微信会校验前后 15 分钟内有效性
nonceStr（注意大小写）不能和第一次下单用的 nonce_str 相同，必须重新生成
package 值固定为 "prepay_id=wx123456789"，不是 "Sign=WXPay"（那是老版本 APP 支付写法）
前端调用 WeixinJSBridge.invoke 时，paySign 必须用第一次下单时的 key 再次签名，且参数顺序严格为：appId、nonceStr、package、signType、timeStamp

回调地址 `notify_url` 收不到通知或验签失败

微信服务器会以 POST 方式、XML 格式、无 Content-Type 头直连你的 notify_url，很多 TP 默认中间件会拦截或解析失败：

不要用 input('post.') 或 $this->request->post() 读取 —— 必须用 file_get_contents("php://input") 原始读取
验签前先将 XML 转数组，再剔除 sign 字段，按 key 升序拼接 k=v& 字符串，末尾加 key，再 MD5 —— 注意：所有 value 都要原样参与，不能 trim、urldecode 或转义
成功处理后必须原样返回 <xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>，且 HTTP 状态码为 200，多一个空格或换行都会导致微信重试
TP5.1+ 默认开启 session_start()，但微信回调不带 cookie，session_id() 为空会导致部分逻辑异常，建议回调入口禁用 session

支付授权目录总提示「不在白名单」

这个错误和域名备案无关，纯路径匹配问题。微信只校验「发起 JSAPI 支付的那个页面 URL 的路径部分」：

比如用户访问的是 https://a.com/pay/index?order=123，那么授权目录必须填 https://a.com/pay/（结尾斜杠不能少）
TP 路由带 index.php 的，如 https://a.com/index.php/Pay/index，目录就得写 https://a.com/index.php/Pay/
测试时用开发者工具，务必把测试微信号加进公众号「网页授权白名单」，否则 openid 拿不到，下单直接报 NOAUTH

微信回调可能在支付成功后几分钟才到达，且会重复推送；签名字段大小写、空格、编码、XML 解析方式稍有偏差就会验签失败 —— 这些细节没有日志根本没法排查。别省事，file_put_contents('./wx_notify.log', print_r($raw, true), FILE_APPEND) 这类临时日志该加还得加。