回调接口必须校验签名，需按支付平台规则拼接原始参数并url decode后验签，密钥从环境变量加载；幂等性靠订单号+状态机控制，禁止重复处理；响应必须为纯文本“success”且状态码200；日志须带订单号且不脱敏。
回调接口必须校验签名，否则直接拒收
第三方支付平台（如微信、支付宝）的回调请求不走登录态，无法依赖 session 或 token，唯一可信的是他们附带的签名。Gin 里不能只靠 ctx.PostForm("sign") 拿参数就去验签——因为原始参数顺序、空值处理、编码方式都影响签名结果。微信要求按 key 字典序拼接，支付宝要求去除 sign 字段后拼接，且都需 URL decode 后再验。
- 用
c.Request.FormValue("sign")获取签名，但验签前必须用c.Request.PostForm获取全部原始表单数据（避免自动 decode 导致两次 decode 错误） - 不要用
c.ShouldBind(&struct{})，它会提前解析并修改原始 body，导致验签失败 - 微信回调 body 可能是 XML，支付宝是 form-data 或 JSON，需先判断 Content-Type 再统一提取原始参数
- 验签密钥绝不能硬编码，应从环境变量或配置中心加载，例如
os.Getenv("PAY_CALLBACK_KEY")
幂等性必须靠业务单号 + 状态机控制
支付平台可能因超时重试多次推送同一回调，而数据库写入、发消息、扣库存等操作不是天然幂等的。靠数据库唯一索引（如 order_no）只能防插入重复，无法解决「已成功但响应超时→重试→再次处理」的问题。
- 在事务内先查订单当前状态：
SELECT status FROM orders WHERE order_no = ? FOR UPDATE，状态为"paid"或"processing"则直接返回 success - 只允许从
"unpaid"→"paid"的单向状态跃迁，其他情况一律拒绝更新 - 记录回调原始请求体和时间戳到
callback_logs表，便于对账和排查重复 - 不要用 Redis setnx 做临时锁——网络分区或进程崩溃会导致锁残留，反而阻塞后续合法回调
Gin 中正确读取并响应回调的三步闭环
很多开发者用 c.JSON(200, gin.H{"code":0}) 返回，但微信/支付宝要求纯文本响应（如 "success"），且 HTTP 状态码必须是 200，body 不能含空格、换行、BOM 头。Gin 默认 JSON 响应带 Content-Type: application/json，会触发微信重试。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
c.String(200, "success")或c.Status(200)+c.Writer.WriteString("success")确保响应干净 - 务必在验签通过、幂等确认、业务逻辑执行完毕后才写响应，中间任何 error 都应返回
c.String(500, "")（微信要求空响应也视为失败） - 加
defer c.Request.Body.Close()防止连接复用时 body 被提前 consume，尤其当用ioutil.ReadAll(c.Request.Body)读原始 body 时 - 禁用 Gin 的 Recovery 中间件对回调路径的 panic 捕获——它会返回 HTML 页面，导致支付平台认为回调失败
日志与监控必须绑定订单号，且不可脱敏
生产环境出问题时，你只有订单号能串起整个链路。但很多人把 order_no 写进日志时做了掩码（如 ***1234），导致无法关联支付平台提供的原始回调 ID 和数据库记录。
- 所有日志语句必须显式携带
order_no字段，例如log.Printf("[callback] order_no=%s, event=verify_start", orderNo) - 错误日志要包含原始请求 body（截断前 512 字节即可），方便比对签名字段是否缺失或格式异常
- 接入 Prometheus 时，用
http_request_duration_seconds{handler="pay_callback", status_code="200"}区分成功/失败，而不是笼统统计 - 不要在日志里打印密钥、用户身份证号等敏感字段，但
order_no、out_trade_no、trade_status属于必要追踪字段，不属敏感信息
真正的难点不在代码怎么写，而在每次回调都要同时满足：验签零误差、状态跃迁无歧义、响应格式零偏差、日志线索不断档。少一个环节，线上就可能出现资金差错，而且很难回溯。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
