App微信登录提示服务器失败，绝大多数情况下不是微信官方出了问题，而是你的app在微信开放平台的配置、服务器回调逻辑或客户端的请求方式这3个环节中有一个卡住了。 接下来按从简单到复杂的顺序排查,最快1分钟能恢复。
微信登录服务器失败怎么回事？先分清这3种情况
遇到问题先别急着怪微信，先确认一下影响范围,这能帮你少走很多弯路。
所有用户都登录失败，但app其他功能正常
这种情况几乎可以断定是app和微信服务器之间的“桥梁”断了，所谓桥梁就是微信开放平台应用的AppID、Secret、回调地址和签名配置，行业共识认为,相当一部分微信登录失败问题都出在配置串号或回调地址不一致上。
只有部分用户失败，集中在特定网络或机型
先别改代码，让身边的同事用不同运营商网络、不同安卓机型试一次，如果只有某个WiFi下的手机失败，多半是该网络环境无法访问微信域名，比如公司防火墙屏蔽了api.weixin.qq.com，如果是只有某个安卓机型失败,那要重点检查该机型的WebView内核或微信版本是否过低。
只有你一个人测试失败，别人都正常
这种最气人，因为代码和配置看起来都对，你先看看自己手机上的微信是否处于登录状态，然后试试清除微信缓存，另一个常见坑是微信开放平台的“测试范围”限制，如果你把应用状态设置成了“未发布”，只有白名单里的微信号才能授权,其他号登录就会被服务器拒绝。
app微信登录提示服务器错误，按这7步自查解决
不管哪种情况，下面这套排查流程都适用，按照顺序来,每步只需要几分钟。
第1步：核对AppID和Secret是否“配对”
打开微信开放平台，确认你用的是移动应用的AppID，不是网站应用或公众平台的AppID，同时检查Secret有没有在后台被重置过，如果app端的Secret改动后，服务器端还拿着旧Secret去换token,登录肯定失败。
第2步：核对授权回调域名
这里最容易出错，微信授权登录时，app请求的Redirect_URI必须和开放平台填写的授权回调域名完全一致，包括协议头、域名、端口，一个字符都不能差，别小看那种“http和https混用”“多个了www”之类的小问题，微信服务器会直接判定为非法请求,具体场景：
- 你在开放平台填写的是https://api.yourdomain.com/callback，但代码里写的是http://api.yourdomain.com/callback,失败。
- 你填写的是yourdomain.com，但代码用的是login.yourdomain.com,也失败。
第3步：确认Android包名和签名，iOS的Universal Links
Android和iOS的登录校验维度不一样,分开检查。
Android：包名、签名MD5必须和开放平台一致
微信服务器在authorize时会通过签名校验app身份，你需要用微信官方提供的签名生成工具，读取你当前打包所用证书的MD5，然后和开放平台里填的那个对比，哪怕换了台电脑打包，签名变了,也会登录失败。
iOS：Universal Links配置错误是重灾区
如果你的app已经启用了Universal Links，那需要做三件事：在Apple Developer里开启Associated Domains，把apple-app-site-association文件放到可访问的HTTPS根目录，在微信开放平台里填写对应的applinks链接，漏掉任何一个，微信都会在跳转回调时找不到你的app，表现为“服务器失败”或“无法完成授权”。
第4步：看服务器日志，别只看客户端提示
客户端提示“服务器失败”太过笼统，真正的错误原因在服务器调用微信接口的返回报文里，打开后端日志，找到微信登录相关的请求记录，重点看返回的errcode和errmsg，如果看到微信登录接口报错,优先对照下面这张表。
| 返回码 | 含义 | 常见场景 |
|---|---|---|
| 40029 | code无效 | 前端传的code过期或已被使用 |
| 40163 | code已使用 | 同一个code被重复拿去换token |
| 42002 | refresh_token过期 | 刷新access_token的凭证失效 |
| 40013 | appid非法 | 传错了appid |
这些错误码是微信官方文档里公开的,遇到哪个就按对应方向去改。
第5步：检查服务器到微信API的网络链路
App前端和微信服务器之间的交互只是第一步，更关键的是你的后端服务器要主动调用两个接口：用code换access_token，以及用access_token获取用户信息，如果后端服务器所在机房无法访问api.weixin.qq.com，或者被防火墙拦截了HTTPS请求，那前端登录流程走到一半就会断掉，你可以在国内服务器上执行curl -I https://api.weixin.qq.com,看看是否返回正常状态码。
第6步：清理微信客户端的授权缓存
如果你反复测试同一个微信账号，微信客户端里会缓存对该app的授权状态，部分版本在缓存过期后，重新授权时会拿旧的code去请求，导致服务器来回验证失败，操作路径：微信 → 我 → 设置 → 隐私 → 授权管理，找到你的app，删除授权,再重新登录。
第7步：升级第三方登录SDK
如果你用的不是微信官方SDK，而是某家第三方一键登录服务，那问题可能出在第三方SDK和微信开放平台的新策略不兼容，近年来微信明显加强了对未发布应用的授权限制，老版本SDK容易出现偶发性的“服务器失败”，建议你把SDK升级到最新版,并去对应服务商后台查看是否要同步更新密钥。
微信授权登录失败怎么回事？可能卡在“正在加载”或“登录失败”的细节
同样是登录失败,不同卡点对应的修复方向完全不同。
“正在加载”卡住，多半是前端的问题
打开app点微信登录，弹窗一直转圈，没有跳转到微信，这时候后端日志里通常没有请求记录，重点检查app是否有网络权限，以及是不是用了webview内嵌页面，而页面没有做微信UA适配，一个具体场景：app内用Android系统WebView加载微信授权地址，如果没有开启JavaScript和允许重定向,页面就会一直停在加载状态。
“登录失败”弹窗，多数是code换取token这一步挂掉了
前端拿到授权code之后，会把它交给后端服务器，由后端去调微信接口，如果这一步出错，微信不会直接告诉你细节，只会统一返回“登录失败”，所以遇到这种提示，别去反复点重试，先去后端看日志,重点看access_token请求返回是网络超时还是业务错误。
回调地址里带了多余参数
有些开发者在授权链接里追加了自定义参数，比如加入state字段，这本身是允许的，但如果state里包含中文或空格，并且没有做urlencode，微信服务器在回跳时可能解析失败，被误判为服务器错误，解决办法：对参数统一做URL编码,或者在后端处理state时先解码再使用。
时间戳和随机数问题
微信登录接口需要生成一个timestamp和nonceStr，这是为了防篡改，如果你的服务器时间快了几分钟，或者随机数生成逻辑在分布式环境下重复了，微信签名校验会不通过，提示服务器失败，检查一下服务器时间是否启用了NTP同步,以及随机数生成是否足够随机。
怎么避免以后再次出现微信登录服务器失败
登录失败这件事，一次是事故，两次是经验，从配置到运维,提前做好这几件事能省下大把客服时间。
把开放平台配置纳入版本管理
不要只靠人工在网页后台改来改去，把AppID、回调域名、签名信息整理到内部文档里，每次发版前用脚本去比对线上配置和代码里的配置，我们团队就吃过亏：一次打包换了证书，忘了同步开放平台签名，导致新版本全部用户登录失败,回滚之后才发现是配置不一致。
设置token过期提醒和自动刷新
微信的access_token有效期是7200秒，refresh_token有效期是30天，在服务器端写好定时任务，提前刷新access_token，避免因为token过期而返回服务器错误，要对刷新失败做监控报警，不然凌晨token突然失效,用户白天一打开app全挂。
上线前在不同网络下做回归测试
至少覆盖三种场景：WiFi、4G/5G、代理网络，还要用不同微信版本进行测试，业内专家指出，微信登录问题中有不少是“只在某个网络环境”或“只在某个旧版微信”下复现的，这类问题很难靠代码审查发现,只能靠回归测试。
准备一个备用登录方式
即使微信登录配置完美，微信官方接口也可能因为政策调整或临时维护出问题，多接入一个手机号登录或小程序扫码登录,能在关键时刻保住用户留存。
微信登录服务器失败并不可怕，核心就是“配置、网络、签名”三件事。 下次遇到这个提示，先按本文的7步顺序排除，别急着改代码，多数情况下，问题出在开放平台后台某个字段上,改完立刻恢复。
微信登录服务器失败常见问题Q&A
微信登录服务器失败，换一个网络就正常了，这是什么原因？
如果你用WiFi时提示服务器失败，切换到4G就正常，说明当前WiFi网络对微信域名解析不干净，或者所在局域网存在DNS劫持，解决方法是把路由器和手机DNS改成223.5.5.5或114.114.114.114,再重新登录测试。
app微信登录提示“服务器错误”但网页版微信正常，是微信出问题了吗？
不是，网页版微信能登录说明微信官方身份认证服务是正常的，问题出在你的app与微信服务器之间的数据交换环节，按上面第1到第7步排查就好,绝大多数是配置不一致或网络链路不通。
微信登录服务器失败和安卓、iOS有关系吗？
关系不大，但iOS的失败原因更集中在Universal Links配置上，安卓则更多出在包名签名不匹配上，如果你在双端都做了严格校验,两平台的登录成功率并没有明显差异。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/684681.html
