微信小程序制作完成后，千万别忘了这3项配置！

小程序代码写完了，功能跑通了，提交审核前是不是就能松一口气了？很多开发者和商家都在这时候踩过坑——小程序上线后，发现某个功能不能用、某个页面打不开、用户授权弹不出来，手忙脚乱地改代码重新提交，又等一两天审核。其实这些问题绝大多数不是因为代码写错了，而是有几项关键配置在上线前被漏掉了。下面这3项配置，做完小程序后一定要逐个检查，少一项都可能让你的小程序“半残废”。

第一项：服务器域名配置（request合法域名）

这是最容易忽略也是最致命的一项。小程序在开发工具里调试时，默认不校验域名，所以很多功能跑得好好的。但一到真机上，你会发现所有请求后端接口的地方都报错“URL not in domain list”。原因很简单：微信小程序要求所有网络请求的域名，必须提前在后台配置到“request合法域名”列表中，而且域名必须备案、支持HTTPS。

正确操作：登录微信公众平台，进入小程序后台，在“开发”->“开发管理”->“开发设置”里找到“服务器域名”。把你要请求的API域名添加到request合法域名里。注意不要加路径，只写到域名级。另外，如果用了WebSocket、上传下载等功能，对应的socket合法域名、uploadFile合法域名也要配全。漏配任何一个，对应的功能在线上就会彻底失效。据深圳小程序开发-沙漠风团队统计，第一次提审的小程序中，超过40%因为域名配置问题被退回或上线后出现白屏。所以提交前，一定拿真机开“调试模式”关掉，模拟真实环境测一遍。

第二项：业务域名配置（web-view组件必备）

如果你的小程序里使用了web-view组件来嵌入H5页面（比如展示富文本文章、外部活动页），那么除了request域名外，还要单独配置“业务域名”。这个配置的位置和上面差不多，在同一个页面的下方。需要注意的是：业务域名同样要求HTTPS，而且需要你在服务器根目录下上传一个微信提供的验证文件，以证明你对这个域名的所有权。

很多人漏掉这步后，web-view组件在真机上直接显示空白或报错“不支持打开非业务域名”。另外，业务域名不支持配置端口和路径，必须是一级或二级域名。如果你嵌入了多个不同子域名下的H5，每个都要单独添加。沙漠风曾接手一个客户，小程序上线后用户反馈“活动页面打不开”，排查半天发现是业务域名配漏了一个子域名。就这么一个小配置，白白损失了两天的订单。

第三项：用户隐私保护指引与授权配置

2023年起，微信对用户隐私保护的要求越来越严。如果你的小程序用到了用户手机号、地理位置、相册、剪切板等敏感信息，必须在后台填写“用户隐私保护指引”，同时在代码里调用相关接口前，先通过`wx.getPrivacySetting`判断是否需要弹窗同意。很多老项目升级或新项目上线时，忘了在后台填写指引，结果一调用隐私接口就直接报错，用户完全无法操作。

具体做法：在小程序后台“设置”->“基本设置”->“服务内容声明”里找到“用户隐私保护指引”，按实际情况填写收集了哪些信息、用途是什么。另外，在代码的app.json或页面中配置隐私授权弹窗的触发逻辑。一个常见错误是：开发者只在真机调试时点了“同意”，就以为没问题，但实际上新用户第一次使用时，如果没有正确配置隐私指引和弹窗，授权会静默失败。沙漠风建议在上线前用一台从未登录过该小程序的测试机，完整走一遍注册登录流程，确认每一步授权都能正常弹出和通过。

最后提醒一下

以上三项配置，域名类的一般在提审前做好就生效，隐私指引可以随时修改但需要重新提交审核。最好列一个“上线前配置清单”，逐项打勾确认。如果你对后台操作不熟悉，或者项目比较急，可以找有经验的服务商帮忙把关——比如深圳小程序开发-沙漠风在交付项目时，都会附上一份详细的配置检查表，并远程协助客户完成这些设置。多花十分钟检查，少等两天重新审核，这笔账怎么算都划算。