支付宝集成常见问题根源在于参数跳转与URL构造、自动加载未触发、密钥格式错误、异步通知数据源污染、沙箱配置不当及账号误用。需规范SDK初始化、严格校验密钥格式、关闭input_filter、显式指定沙箱网关并使用对应凭证与账号。
别用控制器拼参数跳转，也别手动构造支付 URL——验签失败、沙箱失效、同步丢失上下文，90% 都是这一步埋的雷。
AlipayEasySDKFactory 初始化报 Class not found
不是没装包，而是自动加载没触发。确认两点：
- 执行过
composer require alipay/easysdk，且vendor/alipay/easysdk目录存在 -
think\facade\App::getAppPath()返回路径下能定位到vendor/autoload.php，且它已被 ThinkPHP 主入口（如public/index.php）显式引入
如果用的是 TP6.1+，还要检查是否禁用了 Composer 自动加载（比如自定义了 Loader 类但漏掉了 vendor/composer/autoload_psr4.php）。
private_key 和 ali_public_key 格式错导致 ILLEGAL_SIGN
支付宝 RSA2 签名对密钥格式极其敏感，任何多余字符都会让 verify() 直接返回 false：
立即学习“PHP免费学习笔记（深入）”；
-
private_key必须完整包含-----BEGIN RSA PRIVATE KEY-----和-----END RSA PRIVATE KEY-----行，不能删头去尾，不能 base64 decode 后再传 -
ali_public_key是「支付宝公钥」（在开放平台「应用公钥证书」页下载），不是你上传的「应用公钥」；同样要带-----BEGIN PUBLIC KEY-----头尾 - 密钥字符串里不能有换行符、空格、制表符或中文标点——建议用
trim(str_replace(["\r", "\n", " ", "\t"], "", $key))清洗后再传入配置
notify_url 验签始终失败，但密钥明明是对的
问题不在密钥，而在数据源被污染。支付宝异步通知要求原始 POST 数据流，而 ThinkPHP 默认行为会破坏它：
- 必须在 notify 路由对应的中间件或控制器开头加
Request::instance()->filter(false)，关掉 input_filter - 不能用
$_POST或$request->post()去取参数——SDK 内部要用file_get_contents('php://input')读原始 body - 如果项目全局启用了 JSON 解析中间件（比如处理前端
application/json请求），需确保 notify 路由排除该中间件，否则php://input已被提前读空 - Nginx 配置若强制重写
Content-Type（例如把application/x-www-form-urlencoded改成multipart/form-data），会导致$_POST为空，php://input却含原始数据——此时更要依赖 SDK 的原始流解析逻辑
沙箱环境跳转后提示 INVALID_PARAMETER
这不是参数错，是网关没切过去。EasySDK 默认走正式网关，沙箱凭证无效：
- 配置中必须显式指定
'gateway' => 'https://openapi.alipaydev.com/gateway.do' - 沙箱
app_id、private_key、ali_public_key全部要从沙箱应用页复制，和正式环境完全隔离 - 沙箱
notify_url和return_url必须可被支付宝服务器访问——本地开发需配内网穿透（如 ngrok），且 URL 中不能含localhost或私有 IP
最常被忽略的一点：沙箱账号付款时，必须用沙箱买家账号扫码或登录，用真实支付宝账号会直接走正式通道，密钥不匹配就报错。
