wx_service/docs/common/reports/qiniu_callback_validation_2026-02-28.md

七牛直传与回调验签验证记录（2026-02-28）

对应 issue：#13 [P1][T10] 七牛云直传配置与回调验签

验证项

1. 上传凭证配置

• QINIU_CALLBACK_URL/QINIU_CALLBACK_BODY/QINIU_CALLBACK_BODY_TYPE 已接入配置读取。
• token 生成时 callback 策略可注入 putPolicy。

2. 回调验签

• 七牛回调签名校验方法：VerifyCallbackSignature
• 验证通过：合法签名请求返回 200。
• 验证失败：非法签名请求返回 401。

3. 失败重试策略

• 回调处理约定：
  • 401/400：非重试型错误（验签失败、参数错误）
  • 503：可重试型错误（业务临时故障）

测试命令

go test ./internal/common/qiniu/service -v
go test ./internal/common/qiniu/handler -v
go test ./...