ThinkPHP 5.1 引入微信支付 SDK 详细步骤及常见问题-ThinkPHP-PHP中文网

thinkphp 5.1 集成微信 sdk 必须手动配置 autoload 或显式引入，wxpayconfig 需延迟注入配置，签名失败主因是 key 不匹配或大小写不一致，回调需保留原始 xml 并注意验签键名大小写。

thinkphp 5.1 引入微信支付 sdk 详细步骤及常见问题

直接用官方 SDK 放 `extend` 目录会报类找不到

ThinkPHP 5.1 默认不扫描 extend 下的子命名空间，哪怕你把微信 SDK 的 lib 整体丢进 extend/WxPay，执行时大概率遇到 Class 'WxPayUnifiedOrder' not found 或 Class 'WxPayConfig' not found。这不是路径写错，是自动加载没生效。

解决方式只有两种，且必须二选一：

在 composer.json 的 "autoload" → "psr-4" 里手动加一条："WxPay\" : "extend/WxPay/"，然后运行 composer dump-autoload
放弃 PSR-4 自动加载，改用 require_once 显式引入关键文件（更稳妥，尤其 SDK 命名空间混乱时），例如：require_once EXTEND_PATH . 'WxPay/lib/WxPay.Api.php';

注意：SDK 中部分类（如 WxPay.JsApiPay.php）依赖 WxPayConfig，但它的命名空间是空的或 WxPay，和文件实际位置不匹配——这是官方 SDK 的遗留问题，别指望它开箱即用。

`WxPayConfig` 配置项必须硬编码还是能走 TP5.1 配置系统？

可以走配置系统，但不能直接在 WxPayConfig.php 里调 config() —— 因为该文件在框架初始化前就被 require 进来了，config() 函数还不存在。

正确做法是「延迟注入」：

保留原 WxPayConfig 类结构，但把所有敏感字段（APPID、MCHID、KEY）设为 public static，值留空或占位
在你的支付逻辑开始前（比如控制器方法里），用 TP5.1 的配置覆盖它：WxPayConfig::$APPID = config('wx.appid');
务必确认 KEY 是 32 位 MD5 字符串，且与商户平台「API密钥」完全一致；填错会导致签名始终失败，错误信息是 sign error

漏掉 KEY 同步是最常见的签名失败原因，调试时先打日志看 $params 和生成的 sign，再拿相同参数去微信签名工具比对。

wechat mp push 微信公众号图文生成与推送技能

支持AI生成符合公众号规范的图文，推送至草稿箱；兼容其他技能生成的图文/图片。通过向导扫码授权，支持多账号；无需暴露Secret密钥或配置IP白名单。

下载

统一下单返回 `INVALID_REQUEST` 或 `NOAUTH` 怎么排查？

这两个错误基本指向「appid 和 mch_id 不匹配」或「未开通对应支付场景」。

INVALID_REQUEST：检查 appid 是否填了公众号/小程序的 AppID，而不是商户号；mch_id 是否是纯数字，且与商户平台「账户中心」显示的一致
NOAUTH：重点查「产品授权」——小程序支付必须在商户平台开通「JSAPI 支付」并绑定该小程序 AppID；公众号支付则要绑定公众号原始 ID（不是名称）
测试时用的 openid 必须来自同一主体（同一公众号/小程序），跨主体 openid 会直接被拒，且不提示具体原因

另外，spbill_create_ip 填 127.0.0.1 或内网 IP 也会触发 INVALID_REQUEST，必须填服务器真实外网出口 IP（可用 equest()->ip() 获取）。

回调通知收不到或验签失败的硬伤点

微信回调只认 text/xml 原始 POST 数据，TP5.1 默认会解析成数组并清空原始流，导致 file_get_contents('php://input') 为空。

必须在入口文件或中间件中提前保存原始 XML：

if (isset($_SERVER['HTTP_CONTENT_TYPE']) && strpos($_SERVER['HTTP_CONTENT_TYPE'], 'xml') !== false) {
    $GLOBALS['HTTP_RAW_POST_DATA'] = file_get_contents('php://input');
}

后续在通知处理方法中用 $GLOBALS['HTTP_RAW_POST_DATA'] 解析，别信文档里写的 $GLOBALS['HTTP_RAW_POST_DATA'] 已废弃——微信回调场景下它仍是唯一可靠来源。

验签失败的另一个隐藏坑：微信回调 XML 中的 <sign></sign> 字段是大写，但 SDK 的 makeSign() 方法默认对键名做 strtoupper 处理，若你手动拼接参数数组，键名大小写不一致就会导致验签失败。