◆ MySQL 运行手册 · 2026-04-27 10:20

生产 MySQL 参数到位后的执行清单

开发侧 DB 演练已完成；真实试运行前仍需客户/运维提供生产 MySQL 连接参数并复跑校验。

runbook.jsonDB 演练报告生产化阻断总览上线门禁

客户/运维需提供

  • MySQL host/port/database
  • 独立业务账号权限
  • 网络白名单
  • 备份目录与保留周期
  • 演练窗口
  • 运维与回滚联系人

执行步骤

  1. 确认 MySQL 网络连通和账号权限
  2. 执行 Prisma schema 推送或 migration
  3. 以 DATA_MODE=db 和真实 DATABASE_URL 启动 API
  4. 登录获取 token 并回读受保护接口
  5. 执行备份并记录校验信息
  6. 恢复库校验关键计数
  7. 重新生成 DB 报告和生产化阻断总览
  8. 运行 pnpm -C /wwwroot/xia smoke:v0.1

回滚口径

  • migration 或初始化失败时停止 API 并保留日志
  • 恢复计数不一致时不进入真实试运行
  • 公网 smoke 未通过时不上调上线门禁结论

验收标准

  • API health 返回 dataMode=db
  • RBAC 鉴权 API 回读 PASS
  • 业务表结构不少于 22 张
  • 关键计数恢复一致
  • 公网报告可访问且带 X-NEXUS-Relay: pc1

推荐环境变量

DATA_MODE=db
DATABASE_URL="mysql://xia_user:******@mysql-host:3306/xia_prod"
PORT=3300