zyt/admin/PAYMENT_DEPLOYMENT_CHECKLIST.md

支付功能部署检查清单

开发环境检查

• 代码已提交到版本控制系统
• 所有文件已创建：
  • server/config/pay.php
  • server/app/adminapi/controller/order/AlipayNotifyController.php
  • server/app/adminapi/controller/order/WechatNotifyController.php
  • server/app/adminapi/logic/order/OrderLogic.php (已更新)
  • server/app/common/model/Order.php (已更新)
  • admin/order.sql (已更新)
• 代码通过语法检查
• 代码通过代码审查

测试环境检查

数据库

• 执行数据库迁移脚本
• 验证 trade_no 字段已添加到 la_order 表
• 验证表结构正确

环境配置

• 配置 .env 文件中的支付宝参数
• 配置 .env 文件中的微信支付参数
• 验证配置文件 server/config/pay.php 可以正确读取环境变量

支付宝集成

• 获取支付宝沙箱账号
• 配置支付宝沙箱网关地址
• 配置支付宝回调地址
• 测试支付宝支付流程
• 验证支付宝回调处理正确
• 验证订单状态更新正确

微信支付集成

• 获取微信支付测试账号
• 配置微信支付测试参数
• 配置微信支付回调地址
• 测试微信支付流程
• 验证微信支付回调处理正确
• 验证订单状态更新正确

功能测试

• 测试正常支付流程
• 测试补单支付流程
• 测试支付宝支付
• 测试微信支付
• 测试支付失败处理
• 测试重复支付防护
• 测试金额验证
• 测试签名验证

前端测试

• 支付对话框显示正确
• 支付方式选择正确
• 补单支付订单号输入正确
• 支付完成后订单列表刷新正确
• 错误提示显示正确

后端测试

• 支付接口返回正确的支付URL/数据
• 回调处理正确验证签名
• 回调处理正确验证金额
• 回调处理正确更新订单状态
• 异常处理正确

安全测试

• 验证签名验证不能被绕过
• 验证金额验证不能被绕过
• 验证订单状态检查正确
• 验证权限控制正确
• 验证日志记录正确

生产环境准备

支付宝生产配置

• 获取支付宝生产账号
• 获取支付宝生产密钥
• 配置支付宝生产网关地址
• 配置支付宝生产回调地址
• 在支付宝后台配置回调地址

微信支付生产配置

• 获取微信支付生产账号
• 获取微信支付生产密钥
• 配置微信支付生产参数
• 配置微信支付生产回调地址
• 在微信后台配置回调地址

生产环境部署

• 更新生产环境的 .env 文件
• 执行生产环境数据库迁移
• 部署代码到生产环境
• 验证生产环境配置正确
• 验证生产环境数据库正确

生产环境测试

• 测试生产环境支付宝支付
• 测试生产环境微信支付
• 测试生产环境回调处理
• 验证生产环境订单状态更新
• 验证生产环境日志记录

监控和维护

日志监控

• 配置支付相关日志
• 设置日志告警
• 定期检查日志

性能监控

• 监控支付接口响应时间
• 监控回调处理时间
• 监控数据库查询性能

错误监控

• 监控支付失败率
• 监控回调失败率
• 监控异常错误

定期维护

• 定期检查支付配置
• 定期更新密钥
• 定期清理日志
• 定期备份数据库

文档检查

• 已阅读 PAYMENT_QUICK_START.md
• 已阅读 PAYMENT_GATEWAY_INTEGRATION.md
• 已阅读 PAYMENT_IMPLEMENTATION_SUMMARY.md
• 已阅读 PAYMENT_API_ENDPOINTS.md
• 已阅读 PAYMENT_MIGRATION.md

团队培训

• 开发人员已了解支付流程
• 测试人员已了解测试方法
• 运维人员已了解部署步骤
• 支持人员已了解常见问题

应急预案

• 已准备支付失败处理方案
• 已准备回调失败处理方案
• 已准备数据恢复方案
• 已准备回滚方案

上线前最终检查

• 所有检查项已完成
• 所有测试已通过
• 所有文档已准备
• 所有人员已培训
• 应急预案已准备
• 获得上线批准

上线后监控

• 监控支付成功率
• 监控回调处理
• 监控错误日志
• 监控用户反馈
• 准备应急响应

常见问题排查

支付宝相关

• 签名验证失败 → 检查密钥和参数排序
• 回调未收到 → 检查回调地址和防火墙
• 金额不匹配 → 检查金额计算
• 订单不存在 → 检查订单号

微信支付相关

• 签名验证失败 → 检查密钥和参数排序
• 回调未收到 → 检查回调地址和防火墙
• 金额不匹配 → 检查金额转换（分）
• 订单不存在 → 检查订单号

通用问题

• 支付接口超时 → 检查网络连接
• 数据库错误 → 检查数据库连接
• 权限错误 → 检查用户权限
• 配置错误 → 检查环境变量

签字确认

• 开发负责人：_________________ 日期：_______
• 测试负责人：_________________ 日期：_______
• 运维负责人：_________________ 日期：_______
• 项目经理：_________________ 日期：_______