上线指南

小程序源码上线前怎么验收？从登录到售后的 12 个检查点

一套小程序源码能不能真正上线，不能只看首页和演示视频。本文按用户、运营人员和管理员的实际操作路径，整理 12 个上线前必须验证的检查点。

很多人验收小程序源码时，第一步是打开首页，看页面是否精致、图片是否完整。首页当然重要，但它只能说明前端资源大致能加载，不能说明这套系统可以交付。真正影响上线的，往往是登录状态、接口权限、订单状态和后台处理这些不容易在截图里看出来的部分。

比较稳妥的验收方法，是先画出一条最小业务闭环。以服务预约类小程序为例，用户应该能够从首页进入服务列表，查看服务详情，选择日期和时段，填写地址，提交预约，看到订单状态；管理员则应能在后台看到这条预约、修改处理状态，并让用户端能够读到最新结果。只要其中一个环节靠手工改数据库才能继续，就不能算真正完成。

第一项检查是登录和退出。要分别测试首次登录、重复登录、主动退出、登录过期和更换账号。登录后再关闭小程序重新打开，页面应该根据真实登录状态决定显示什么，而不是仅靠本地缓存把用户当成已登录。退出后访问个人资料、订单和地址等页面，也应得到明确的登录提示，不能把上一个用户的数据留在页面上。

第二项检查是权限。普通用户、运营人员和管理员看到的菜单、数据和操作权限不应该完全相同。尤其要测试一个普通账号是否能够通过修改请求参数访问别人的订单，管理员删除或修改数据后，前台是否仍然显示旧缓存。权限必须在后端判断，前端隐藏按钮只能改善体验，不能代替接口鉴权。

第三项检查是核心数据的增删改查。商品、服务、分类、门店、医生、教练或课程等内容，都要从后台真实新增一条，再回到小程序检查是否能显示；修改标题、价格、图片和上下架状态后，也要检查前台是否及时更新。只在前端写死几条演示数据，会让验收看起来顺利，但上线后无法运营。

第四项检查是表单和边界条件。必填项为空、手机号格式错误、日期早于今天、时段已被占用、数量超过库存、备注过长等情况，都应该有清楚的提示。输入框还要测试复制粘贴、中文、特殊字符和连续点击。一个页面能提交不代表表单可靠，拒绝错误输入同样是功能的一部分。

第五项检查是订单状态。至少要确认待支付、已支付、处理中、已完成、已取消和售后中的状态是否有明确区分。状态改变应该由后端记录，不要只在当前页面临时修改文字。用户重新进入订单页、换一台设备，或者管理员在后台处理后，看到的状态都应该一致。

第六项检查是支付前后的衔接。测试环境可以使用支付预创建或模拟回调，但要确认支付成功、支付取消、重复回调和回调超时都有对应处理。支付回调需要验签并保证幂等，不能因为用户重复刷新或平台重复通知，就生成两笔订单或重复发货。涉及真实收款时，还应单独核对商户号、回调域名和证书配置。

第七项检查是后台可运营性。管理员至少要能维护核心内容、查看用户提交的数据、处理订单或预约、修改状态、查看反馈并管理基础配置。后台的表格需要有搜索、分页和清晰的空状态，否则数据一多就无法使用。保存后重新刷新页面仍然存在，才说明数据确实写入了数据库。

第八项检查是文件和图片。上传图片后要确认返回的是稳定的服务器 URL，而不是本机临时路径；删除或替换图片后，页面不能出现大量失效链接。图片尺寸过大时要有压缩策略，视频和压缩包则要检查大小限制、下载权限和断点失败后的提示。

第九项检查是接口错误。可以在浏览器网络面板或服务器日志中观察 401、403、404、422 和 500 的响应。接口失败时，页面应该显示真实原因或可理解的提示，不能用一组假数据把问题掩盖掉。特别要留意接口返回 HTML、乱码或带 BOM 的 JSON，这些问题会让不同客户端表现不一致。

第十项检查是移动端适配。用常见的安卓和 iPhone 宽度分别操作首页、详情、表单、弹窗和键盘输入。按钮不能被底部安全区域遮住，长标题不能挤压价格和操作按钮，弹窗打开后页面也不应该莫名滚动。适配不是把桌面页面缩小，而是保证每个操作在小屏上都能完成。

第十一项检查是数据初始化和备份。上线前要明确数据库表、初始管理员、分类、配置和演示数据哪些应该保留，哪些必须清理。正式数据导入前先备份数据库，并记录源码版本、环境变量、域名、回调地址和定时任务。没有交付这些信息，后续维护会高度依赖原开发者。

第十二项检查是从零开始复测。清除缓存，使用一个新账号，按普通用户的真实路径再走一遍；同时让管理员在另一端处理数据。只有前台、接口、数据库和 Admin 四个部分能够互相传递真实状态，这套源码才值得进入上线准备。验收清单的价值，不是找茬，而是把上线后的返工成本尽量提前。

常见问题

购买一套小程序源码后，最先应该验收什么？先从一条完整业务流程开始，例如登录、选择服务、提交订单、查看状态和后台处理，而不是只检查首页是否能打开。