支付宝沙箱支付失败主因是密钥配错：alipay.privatekey须为自生成rsa2私钥（pkcs#1格式），alipay.publickey须为沙箱页面获取的完整公钥（含pem头尾）；签名需按字典序拼接未解码参数并url转义；异步通知验签须读原始body、禁用自动解码；沙箱付款后需手动登录买家账号点击“确认付款”才触发成功回调。
支付宝沙箱密钥配置不对，alipay.PublicKey 和 alipay.PrivateKey 容易搞反
沙箱环境跑不通支付请求，十有八九是密钥配错了。支付宝要求你用自己生成的 RSA2 私钥（alipay.PrivateKey）签名请求，用支付宝提供的公钥（alipay.PublicKey）验签返回结果——不是反过来。
常见错误：把支付宝沙箱页面下载的 alipay_public_key.pem 当成自己的私钥塞进 alipay.PrivateKey，导致签名失败；或者漏掉 PEM 头尾（-----BEGIN PUBLIC KEY----- / -----END PUBLIC KEY-----），程序读出来是空字符串。
- 确认私钥是你用
openssl genrsa -out app_private_key.pem 2048生成的，且已转为 PKCS#1 格式（Gin 集成常用 SDK 如ginalipay或alipay默认只认 PKCS#1） - 支付宝沙箱公钥必须从「开发中心 → 沙箱环境 → 沙箱应用 → 查看密钥」里复制完整内容，含头尾行
- 加载密钥时建议用
os.ReadFile后直接传入字符串，别用ioutil.ReadFile（Go 1.16+ 已弃用）
调用 client.GetTradePageUrl 返回 sign_error 或空 URL
这个函数封装了支付跳转页生成逻辑，但签名失败时不会 panic，而是静默返回空字符串或带 sign_error 的错误响应。根本原因通常是参数字段名、排序、编码不一致。
支付宝签名规则严格：所有请求参数（除 sign 和 sign_type）必须按字典序升序排列，value 做 UTF-8 编码 + URL 转义（url.PathEscape 不够，得用 url.QueryEscape），再拼接成 key=value 字符串后签名。
- 别手动拼
body，用 SDK 提供的client.GetTradePageUrl方法，传入alipay.TradePagePayRequest实例 -
subject和out_trade_no必填，且out_trade_no不能重复（沙箱对重复单号会直接拒单） - 检查
notify_url是否用了内网地址（如http://localhost:8080/notify）——沙箱回调只支持公网可访问域名，本地调试建议用ngrok或localtunnel映射
Gin 中处理支付宝异步通知（/notify）验签失败
支付宝 POST 回调到你的 /notify 接口时，数据是 form-urlencoded 格式，且自带 sign 和 sign_type 字段。直接用 c.PostForm 读参再验签，大概率失败——因为 Go 的 ParseForm 会自动解码 URL 编码，而支付宝验签要求原始未解码字符串。
正确做法是：先用 c.Ctx.Request.Body 读原始字节流，再用 url.ParseQuery 解析，保留原始 value（不自动 decode），最后过滤掉 sign 和 sign_type 后按规则拼串验签。
- 别依赖
c.ShouldBind或结构体绑定，它会触发自动解码 - 验签前确保传入的
alipay.PublicKey是支付宝沙箱公钥，不是你自己应用的公钥 - 回调接口必须返回
"success"（纯文本，无空格、无换行、无 HTML），否则支付宝认为失败并持续重试
沙箱买家账号付款后，trade_status 一直是 WAIT_BUYER_PAY
这不是代码问题，是沙箱行为特性。沙箱中买家扫码付款后，状态不会实时更新，需要你主动登录沙箱买家账号，在「交易记录」里手动点击「确认付款」，才会触发 TRADE_SUCCESS 状态和回调。
很多人卡在这里以为接口没通，其实只是少点了一步人工操作。另外注意：沙箱买家账号只能在「沙箱环境」页面登录，不能用真实支付宝账号。
- 登录地址是 https://openhome.alipay.com/platform/appDaily.htm（沙箱环境页 → 「沙箱账号」→ 点击买家账号右侧「登录」）
- 确认付款后，支付宝会立即向你的
notify_url发起回调，此时再查数据库或日志就能看到TRADE_SUCCESS - 如果回调没收到，优先检查
notify_url是否能被公网访问，以及是否返回了严格意义上的"success"
沙箱支付链路里最耗时间的环节，往往不是写代码，而是等人工点那个「确认付款」按钮——这点容易被忽略，但真正在联调时卡住多数人。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
