上线指南

微信小程序上线前的服务器准备：域名、HTTPS、接口和日志怎么查

小程序页面开发完成后，服务器配置仍决定能否提交审核。本文按域名、HTTPS、接口白名单、文件上传、数据库和日志六个方面整理上线前检查方法。

小程序在本地开发工具里运行正常，距离正式上线还有一段距离。开发工具可能允许使用测试域名、忽略部分证书问题，或者直接读取本机服务；真实用户访问时，所有网络请求都要经过微信允许的业务域名，并且服务器需要稳定返回正确内容。上线前把服务器端逐项检查一遍，可以避免审核阶段才发现问题。

第一项是域名。接口、图片、上传文件和视频地址应尽量使用清晰、稳定的正式域名，不要把 IP 地址、localhost、临时隧道或开发环境地址写进前端。域名变更会影响小程序后台配置、证书、接口白名单和已发布版本，因此最好在项目接近完成时就确定正式地址。

第二项是 HTTPS。证书不仅要存在，还要检查域名是否匹配、证书链是否完整、有效期是否充足，以及 HTTP 是否正确跳转到 HTTPS。某些接口在浏览器里能打开，但小程序因为证书链、加密协议或重定向处理不兼容而请求失败。上线前应从手机网络环境访问接口和图片，而不是只在服务器本机测试。

第三项是合法请求地址。小程序常见的请求域名、socket 域名、上传域名和下载域名需要在微信公众平台分别配置。接口如果又调用了第三方地图、支付或短信服务，也要确认这些调用发生在后端还是前端。把敏感密钥放在小程序前端是不安全的，第三方服务的密钥通常应该由后端保存并调用。

第四项是接口响应。接口成功时应返回稳定的 JSON 结构，失败时也要返回明确的状态和错误信息，不要混入 PHP 警告、调试输出、乱码或 HTML 错误页。可以用 curl 或接口工具分别测试 GET、POST、登录失效、参数缺失和权限不足的情况。页面显示“加载失败”时，先看真实接口响应，不要用静态假数据遮盖错误。

第五项是文件上传和访问权限。上传图片后要检查文件是否保存到了预期目录，返回 URL 是否能从外部访问，文件名是否会因为中文、空格或特殊字符失效。源码包、用户资料和配置文件不能放在可公开下载的位置；图片和视频可以公开访问，但管理接口、日志和备份文件必须限制权限。

第六项是数据库连接。正式环境要确认数据库地址、端口、账号权限、字符集和时区，尤其要注意开发库和生产库是否混用。上线前先备份数据库，再导入表结构和必要的初始配置。不要把数据库账号密码直接写进前端，也不要把包含真实密钥的配置文件提交到公开代码仓库。

日志是排查上线问题最有价值的证据。Nginx 或 Web 服务器日志可以确认请求是否到达，应用日志可以确认控制器是否执行，数据库日志可以帮助定位查询和写入错误。遇到页面空白时，先记录请求时间、接口地址、状态码和响应内容，再按同一时间点查日志，通常比反复刷新更快找到原因。

还要准备正确的 404 和 500 处理。不存在的商品、文章或用户资源应该返回合适的错误状态，服务器异常不能把堆栈信息发给用户。前端需要有可理解的错误提示，后台则保留足够的日志。测试一个不存在的详情地址、缺少参数的接口和数据库暂时不可用的情况，可以提前发现错误处理是否完整。

性能检查可以从接口响应时间和文件体积开始。首页接口不要一次返回不必要的大量数据，列表接口要有分页，图片和视频应按移动端实际尺寸压缩。高峰期连续点击提交按钮时，后端要防止重复创建订单；支付回调和文件上传也要设置合理的超时、大小限制和重试策略。

上线前最好做一次全新环境复测。使用新的小程序账号或清除缓存，按照用户路径完成登录、浏览、提交、查看状态和退出；再用管理员处理一笔数据，回到用户端确认变化。把测试结果、正式域名、配置项、备份位置和回滚方式记录下来，后续换人维护时就不必重新猜测环境。

服务器准备不是上线前最后一天才做的杂项，而是小程序能否稳定运行的一部分。域名和 HTTPS 解决访问问题，接口和数据库保证业务闭环，日志和错误处理帮助持续维护。把这些基础工作做好，页面审核通过后才真正具备面向用户运营的条件。

常见问题

微信小程序上线前服务器需要检查什么？重点检查 HTTPS 域名、合法请求地址、接口返回、文件上传、数据库连接和错误日志。