上线指南

小程序上线后如何减少返工？把配置、数据和版本交接一次说清楚

小程序上线后的返工，很多来自交接不完整。把域名、密钥、数据库、后台账号、第三方服务和版本记录整理清楚，后续维护会轻松很多。

小程序上线后出现问题，很多时候不是代码突然失效，而是交接时没有把环境和配置说清楚。开发人员知道接口地址和数据库在哪，运营人员知道后台账号，但真正需要维护时，往往找不到证书、回调地址和最新源码。上线交接不是形式工作，它决定了项目能不能被下一位人员顺利接手。

第一项要整理的是源码和版本。前端、后端、Admin、数据库 SQL、静态资源和部署说明应分目录保存，目录名称和项目名称保持一致。每次上线都记录版本号、发布时间、改动内容和回滚版本，避免出现“服务器上的文件到底是哪一版”的问题。

第二项是环境配置。需要记录 PHP 或 Node 版本、ThinkPHP 版本、MySQL 版本、Web 服务器、定时任务、上传目录和运行用户。配置文件可以保留示例模板，但真实密码、密钥和证书应单独安全保存，不要和前端源码一起公开。

第三项是域名和 HTTPS。要列出接口域名、图片域名、上传域名、下载域名和支付回调域名，确认每个地址都指向正式服务器。证书文件、自动续期方式和到期提醒也应记录。域名更换时，需要同步修改微信公众平台、支付平台、服务器反向代理和前端配置。

第四项是微信平台配置。AppID、AppSecret、业务域名、request 合法域名、uploadFile 合法域名、downloadFile 合法域名和隐私保护配置，都应该由账号所有者掌握。Secret 和支付密钥不能写进小程序前端，也不要通过普通聊天长期传递。

第五项是第三方服务。地图、短信、对象存储、支付、客服和消息通知等服务，要记录服务商、账号归属、用途、回调地址和费用周期。测试环境和生产环境的参数应分开，停用测试服务前，先确认线上是否还在使用对应的密钥或回调。

第六项是数据库和数据备份。交接时说明数据库名称、字符集、时区、账号权限和备份目录，并至少验证一次备份恢复。重要表不应依赖手工导出，定期备份任务需要检查是否真的执行成功，备份文件也要避免和网站公开目录混在一起。

第七项是后台账号和权限。管理员账号不要多人共用，初始密码应在首次登录后修改；开发、运营和只读人员可以使用不同账号。人员离开项目时，及时停用账号、更新密钥并检查服务器登录权限，避免旧账号长期保留。

第八项是上线验收记录。至少记录登录、列表、详情、表单、订单或预约、支付、上传、后台处理和异常提示的测试结果。每项测试注明环境、测试账号、时间、结果和已知限制。以后再次出现同样问题时，可以直接对照记录，不必从头猜测。

第九项是错误和监控。服务器访问日志、应用错误日志、支付回调日志和定时任务日志应有清晰位置和保留周期。遇到页面空白或接口失败时，先按时间查请求和应用日志，不要立即用静态数据替换真实接口。错误信息对用户要友好，对维护人员则要保留足够上下文。

第十项是发布和回滚流程。小改动也要先备份要替换的文件，发布后检查首页、核心详情页、登录和订单接口。若出现严重问题，能够恢复上一版文件和数据库备份。任何没有记录、没有备份、没有验证的直接覆盖，都容易让小问题变成无法定位的大问题。

项目交接的目标不是把一堆文件发出去，而是让接手的人知道每个文件做什么、每个配置在哪里、出了问题先查哪里。把源码、配置、数据、账号和验收记录整理完整，能显著减少小程序上线后的重复沟通和临时返工，也方便后续继续增加功能。

常见问题