怎么执行这份 Runbook
先检查前置条件，再按命令块执行。任何命令都要根据客户环境替换域名、路径、服务名和数据库名，不要复制示例里的占位值直接跑。
部署完成后必须做验证；验证不过就按回滚路径退回，并在交接记录里写清原因。
Runbook
小程序接口域名切换 Runbook
用于把小程序从临时 API、测试环境或 IP 地址切换到正式 HTTPS 域名。
执行命令
命令是模板，不含真实密钥。执行前必须替换项目名、路径、域名、服务名和数据库名。
正式接口检查
curl -I https://api.example.com/wx/home/index curl https://api.example.com/health
代码配置检查
rg "baseUrl|apiBase|requestUrl" . rg "http://|https://" miniprogram
发布前记录
git status --short --branch git log -1 --oneline
前置条件
正式 API 域名 HTTPS 可访问，证书有效，备案和合法域名配置完成。
小程序后台已配置 request/upload/download/socket 合法域名。
后端接口、Nginx、日志、数据库和回滚地址可用。
当前版本号、体验版、审核版和正式版环境已记录。
部署验证
体验版使用正式 API 完成首页、登录、核心业务和错误场景测试。
后端日志能看到小程序请求，并能定位错误。
小程序后台合法域名配置和代码中的 API base URL 一致。
审核版提交前记录版本号、接口域名、测试账号和审核说明。
回滚路径
保留上一版小程序 API 配置和后端临时域名/IP。
正式域名异常时，先回滚小程序配置或发布上一体验版。
如果后端发布异常，回滚 API 服务并保持旧接口可用。
记录回滚原因、影响版本和重新切换前置条件。
交接说明
记录 AppID、版本号、接口域名、合法域名配置、测试账号和审核状态。
不得在 HTTPS/备案/合法域名未通过时切换正式接口。
不要公开小程序后台账号、支付密钥、真实用户数据或审核敏感资料。
