上线验收与运维交接
本篇是完整上线指南的最后一阶段：配置全部完成后，用真实交易证明系统可用，并把日常运维责任交接清楚。验收全部通过后再放开业务。
生产专项检查
先过一遍只在生产才有意义的检查项（通用配置项见上线检查清单，此前各阶段的分项清单见各篇末尾）：
- [ ]
DEPLOY_MODE=PROD生效：界面无任何沙箱入口，开发超管账号无法登录 - [ ] 全站 HTTPS 生效，五个域名与端点配置一致
- [ ] 网关已放行
/unipay与/unipay/callback（易支付另开/epay） - [ ]
/demo/、/test/、swagger 未暴露公网 - [ ] 中间件强口令、业务密钥未重新生成
- [ ] 风控「命中阻断下单」按观察期策略设定（建议初期仅记录）
- [ ] 运维面板自身安全就位：安全入口保留、初始密码已改、（按需）IP 白名单与两步验证（见面板安全）
小额真实支付端到端验证
对每一个上线的通道产品执行一遍，金额用 0.01~1 元：
- 下单：业务系统（或支付调试页）发起真实支付，核对生成的付款链接/二维码正常；
- 付款：真实钱包完成支付（微信无沙箱，本来就要真实验证）；
- 回调：核对订单业务状态自动变为「成功」，且不是靠手动「同步」拉出来的，这样才证明回调链路通；「同步」只是回调不可用时的兜底手段；
- 通知：有
notifyUrl的，核对商户业务系统收到通知且验签通过；平台侧「商户回调推送」页发送记录正常； - 退款：对验证单发起一笔全额退款，核对退款状态成功、资金到账；
- 对账：「资金流水」按当日区间导出，与通道侧对账单核对这笔交易金额一致（导出与对账口径见异常订单与资金流水）。
网关收款场景另按网关收款上线 - 全链路验收用真码过三条链路。
首日观察
上线后 24~72 小时最容易暴露问题，建议每日固定巡检：
| 观察点 | 位置 | 关注什么 |
|---|---|---|
| 商户回调推送 | 回调通知 → 商户回调推送 | 有无持续失败的任务（失败会自动重试，持续失败=商户接收端问题） |
| 通道回调记录 | 回调通知 | 处理状态有无异常堆积 |
| 异常订单 | 交易订单 → 异常订单 | close_paid 等不一致单，出现即按异常订单核实处置 |
| 风险命中记录 | 支付管理 → 支付安全 | 观察期判断误拦情况，决定何时开「命中阻断」 |
| 支付接口日志 | 系统管理 → 日志管理 | 验签失败类报错是否集中出现（提示某商户密钥/签名实现有问题） |
| 应用日志 | 运维面板（一键部署）/ LOG_PATH（源码） | ERROR 级别有无持续输出 |
升级流程
系统升级按以下步骤执行（顺序错了会出现「新按钮不可见」「数据结构不一致」）：
- 看官方更新日志确认本次升级内容与破坏性变更；跨大版本或长期未跟进时，面板建议全新安装再迁移数据（见安装、升级与卸载）；
- 备份：面板「数据安全」导出数据备份（或自建场景自行 pg_dump）；
- 升级后端/前端（面板「版本与构建」检查更新；升级面板不会自动重建业务容器，drift 横幅提示的服务要手动重部署）；
- 数据库执行升级脚本：
update-tables.sql → update-datas.sql，仅适用上一版本→当前版本，不能跨版本（见项目构建 - 数据库准备）； - 执行「同步权限码」（菜单管理页），让新版本新增的按钮权限对已授权角色生效；
- 小额真实支付再验证一笔（回归）。
应急排查链
上线初期最高频的三类故障与排查路径：
「订单一直待支付」 通道回调没进来 → 查端点配置后端 API 地址公网可达 → 网关 /unipay/callback 已放行 → 通道回调记录有无该单 → 有记录但订单未更新看异常订单 → 兜底用订单「同步」拉状态。
「商户说收不到回调」 先看「商户回调推送」：有记录且失败 → 商户接收端问题（地址不通/验签失败/应答格式不对，发送详情里有 HTTP 状态码与错误信息，可手动重发）；无记录 → 商户下单没传 notifyUrl 或传错。排查方法论见回调与通知。
「面板进不去」 面板安全防线（安全入口/IP 白名单/两步验证/登录锁定）任一触发都会表现为进不去，按锁死恢复通道汇总用 daxpay 命令行恢复（entrance show / ipallow disable / unlock 等，不依赖面板进程）。
运维交接清单
把以下信息交接给日常运维责任人：
- 部署形态与入口：部署路径（一键/源码）、面板安全入口与恢复命令、各端域名清单
- 凭证保管：管理员账号发放记录、业务密钥不重新生成的红线、商户对接密钥的保管规范
- 日常巡检项：上文首日观察表转为日常频率（建议回调推送/异常订单每日，风险命中每周）
- 数据备份策略：面板导出或自建 pg_dump 的周期与保留（注意日志清理不可恢复，见日志与监控）
- 升级流程：上文六步
- 应急联系路径：通道侧（微信/支付宝商户平台工单）、面板故障（命令行恢复）、业务排查（接口日志与回调推送）