周一早上九点，客服群里接连有人截图：小程序转圈、白屏、弹“网络异常”。老板第一反应是让技术“赶紧重启服务器”。重启有时候管用，但更多时候是白折腾，因为小程序访问失败的原因分散在好几层，服务器只是其中之一。
排查前先花两分钟做一件事：判断是所有人都打不开，还是只有部分用户。这一步决定了你往哪个方向查。
先分清影响范围
找三四个人，用不同手机、不同网络（Wi-Fi 和流量都试）打开同一个页面。
如果大家都打不开，问题多半在你这边：域名、证书、服务器、接口，或者小程序本身的状态。如果只有个别人不行，往用户那一侧查：网络、微信版本、手机系统、缓存。
还有一种情况是“能打开但数据出不来”，首页框架在，列表空白。这说明小程序本身能访问，是接口那一层出了问题，直接跳到下面接口超时那一节。
所有人都打不开：按这个顺序查
1. 小程序的状态是否正常
先登录小程序后台看通知。小程序访问如果被平台限制，比如因违规被暂停服务、某个页面被下架，打开时一般会有明确的提示页，后台也会有站内信。这种情况重启什么都没用，要按通知整改和申诉。
2. 服务器域名有没有配置
报错里出现“不在合法域名列表中”之类的字样，就是服务器域名没在后台登记，或者登记的和代码里调用的对不上，比如少了 www、多了端口。开发时勾了“不校验合法域名”，本地一切正常，上线才暴露，这是新项目最常见的一种小程序访问失败。
3. 证书是否过期或配置不全
小程序要求接口走 HTTPS。证书过期、证书链不完整、域名和证书不匹配，都会让请求直接失败，报错里常带 ssl 或 certificate。证书到期这件事特别容易忘，建议给它设提醒，或者用自动续期。
4. 域名备案和解析
域名备案被注销、域名到期没续费、解析被误改，接口域名就访问不到了。用电脑浏览器直接打开接口地址试一下，打不开就基本锁定在这一层。
5. 最近有没有发版或改配置
故障如果刚好出现在发布新版本、改了服务器配置或者换了接口地址之后，先怀疑这次改动。新版本有问题的，可以在后台回退到上一个线上版本，先恢复小程序访问，再慢慢查代码。很多团队出了事只顾着查服务器，忘了问一句“昨天谁动过什么”。
图 1：只有部分用户打不开时，先查用户网络、微信版本和本地缓存。
- 先分清影响范围：不同手机、Wi-Fi 和流量都试；
- 看小程序后台通知，是否被暂停服务或页面下架；
- 查服务器域名是否登记在合法域名列表，和代码调用一致；
- 查证书是否过期、证书链是否完整、域名是否匹配；
- 查域名备案、续费和解析是否正常；
- 查最近是否发版或改配置，必要时先回退到上一个线上版本。
页面能开、数据加载不出来
这类问题通常在服务器和接口。
请求发出去了但迟迟没有回应，就是超时。原因可能是服务器资源被占满、数据库慢查询、某个第三方接口拖住了整条链路。做活动时流量一下子上来，最容易出这种事。
处理思路很朴素：先看服务器负载和错误日志，找到慢的那个接口；临时可以扩容或限流，长期要优化查询、加缓存。前端也要做兜底，接口超时给出“稍后重试”的提示，而不是一片空白让用户以为小程序坏了。
只有部分用户打不开
如果只是少数用户反馈小程序访问失败，可以让他们按这个顺序试：
- 切换网络，Wi-Fi 换成流量，或者反过来；公司内网有时会拦截部分域名；
- 把微信升级到最新版本，手机系统太老的也可能不兼容；
- 删除小程序后重新搜索打开，清掉本地缓存；
- 还不行，把手机型号、微信版本和报错截图发给你们的技术。
技术这边要留意一个容易被忽视的原因：代码里用了较新的基础库能力，但没做低版本兼容。后台可以设置最低基础库版本，低于它的用户会被提示升级，比打开后报错体验好得多。
体验版、开发版打不开
测试同事说打不开，先确认他扫的是什么版本。开发版二维码有时效，过期就失效；体验版需要在后台把他加为体验成员。这两种都不是线上故障，别被吓到。
结论
遇到小程序访问失败，先判断影响范围：所有人打不开，就按小程序状态、服务器域名、证书、备案解析的顺序查；页面能开但没数据，查接口和服务器负载；只有部分人打不开，从网络、微信版本、缓存和基础库兼容入手。平时把证书到期、域名续费设好提醒，能避开不少突发状况。如果你的小程序反复出问题又找不到原因，蔚岚科技可以帮你做一次排查，电话 18720919319，小程序开发与维护也可以交给我们。
常见问题
小程序打不开，重启服务器有用吗？
只有服务器本身卡死时才有用。域名没配置、证书过期、小程序被暂停服务这些情况，重启解决不了，先看报错再动手。
为什么电脑上开发者工具能访问，手机上不行？
多半是开发时关掉了合法域名校验。手机和线上环境会校验服务器域名和 HTTPS 证书，去后台把域名登记好、检查证书即可。
小程序提示“暂停服务”是什么原因？
一般是平台判定存在违规，限制了访问。登录后台看具体通知，按要求整改后提交申诉，规则以平台最新说明为准。
小程序访问很慢算不算故障？
慢到超时就是故障。常见原因是图片太大、首页请求太多、接口查询慢，可以从压缩图片、合并请求和优化后端入手。
怎么提前发现小程序访问出问题？
给核心接口做定时监控，失败时自动通知技术；证书和域名设到期提醒；后台的错误日志和用户反馈定期看一眼。