Composer安装支付宝SDK仅下载文件，不解决配置、签名、环境适配等问题；需严格校验app_id、密钥格式、网关地址、PHP扩展，并正确处理查询失败与验签失败的业务逻辑。
Composer 安装支付宝 SDK 并不能直接解决接口调用问题——它只是把 SDK 文件拉下来，后续所有配置、签名、环境适配、错误处理都得手动补全，漏一项就可能卡在 sign check fail、isv.invalid-app-id 或 ACQ.SYSTEM_ERROR 上。
为什么 composer require alipay/easysdk 后还是调不通？
因为 EasySDK 只封装了请求发送和基础验签逻辑，不自动处理以下关键项：
-
app_id必须与开放平台应用的 APPID 完全一致（含空格、换行） -
private_key和alipay_public_key必须是 PEM 格式且无多余字符（常见坑：Windows 换行符、Base64 尾部多出的=或换行） - 沙箱环境必须用
https://openapi-sandbox.dl.alipaydev.com/gateway.do，正式环境必须用https://openapi.alipay.com/gateway.do，混用必报isv.invalid-app-id - PHP 环境需开启
openssl和curl扩展，否则连网络请求都发不出，错误可能静默失败或抛出Call to undefined function openssl_sign()
alipay.trade.query 调用返回 ACQ.TRADE_NOT_EXIST 怎么办？
这不是 SDK 问题，而是业务状态不一致导致的典型误判。该错误表示支付宝侧查不到这笔交易，但不代表你没发起成功——比如用户已跳转收银台但未付款，或你用了错的 out_trade_no。
- 先确认你传的
out_trade_no是自己系统生成的、唯一且未被复用的订单号 - 如果刚调完
alipay.trade.pay就立刻查，可能因异步写入延迟查不到，建议等待 1–2 秒再查，或改用轮询（最多 30 秒） - 若确定订单已支付却仍返回此错误，检查是否在沙箱环境用了正式环境的
app_id或密钥对，导致请求根本没进沙箱网关 - 不要仅凭查询失败就退款或重下单——先人工核对支付宝商家后台的交易流水
遇到 sign check fail: check Sign and Data Fail 到底要不要重试？
要分情况：这个错误说明请求已发到支付宝并收到了响应，但 SDK 验签失败。此时交易状态未知，不能简单认为“失败”或“成功”。
- 如果是支付类接口（如
alipay.trade.pay），必须立刻调用alipay.trade.query查单，根据返回的trade_status判断真实状态 - 如果是通知类接口（如异步通知验签失败），检查你用的
alipay_public_key是否和开放平台上传的公钥完全一致（注意：不是应用公钥，是支付宝公钥） - 常见低级错误：把
get请求参数拼接后验签，却忽略了支付宝通知是POST且含文件上传字段，实际应只对$_POST中的非文件字段排序验签 - 别在日志里只记 “验签失败”，要同时记录原始响应体全文（
$_POST+$_GET+ 响应 headers），否则无法回溯是数据被截断、编码被转义还是签名算法不匹配
真正的难点从来不在装 SDK，而在于每笔请求背后那几处必须严丝合缝的配置和状态判断——尤其是当 return_url 跳转成功但异步通知没收到、或查询返回 WAIT_BUYER_PAY 却用户坚称已付款时，这些边界场景才是压垮调试节奏的关键。
