状态码造成微信公众号“该公众号提供的服务出现故障”

bug描述

我们使用NestJS写后台代码，给微信公众号提供服务。

用户给公众号发消息时，公众号会显示“该公众号提供的服务出现故障”。

虽然后台代码可以正常处理业务，但这个提示非常影响用户体验。

检查

根据微信公众号文档给的提示，出现这个问题的原因是没有给微信服务器返回正确的信息。

微信服务器需要的是success或者空的字符串。不能是json格式的字符串。

搜了一下其他文章，有的说xml里也不能带有空格；有的说公众号绑定了第三方平台，要去解绑。

但这些和我们的情况不一致。

给公众号的接口是默认返回success的。

查看运行log，发现用户发送1条消息给公众号，我们的服务端会收到4条一模一样的消息。

这4条消息的MsgId是一样的。网上也有人提供了防止重复消息的办法。

于是尝试以下方法

维护一个map，key是MsgId。

接收到消息后，如果发现是重复的MsgId，则立刻返回success（或者空字符串）。

但是问题依旧没有解决。

微信服务器认为它没有拿到正确的返回值，于是走了重试的流程。

我们ubuntu服务器上使用了nginx，于是我们查看nginx的log

81.69.1.1 - - [03/Aug/2021:09:41:25 +0800] "POST /mywxserve/?signature=sign1111×tamp=1627954885&nonce=1832145745&openid=qqq HTTP/1.1" 201 0 "-" "Mozilla/4.0" 81.69.1.1 - - [03/Aug/2021:09:41:26 +0800] "POST /mywxserve/?signature=sign1111×tamp=1627954885&nonce=1832145745&openid=qqq HTTP/1.1" 201 7 "-" "Mozilla/4.0" 81.69.1.1 - - [03/Aug/2021:09:41:26 +0800] "POST /mywxserve/?signature=sign1111×tamp=1627954885&nonce=1832145745&openid=qqq HTTP/1.1" 201 7 "-" "Mozilla/4.0" 42.192.1.1 - - [03/Aug/2021:09:41:26 +0800] "POST /mywxserve/?signature=sign1111×tamp=1627954885&nonce=1832145745&openid=qqq HTTP/1.1" 201 7 "-" "Mozilla/4.0"

可以看到有2个ip地址，发来了3+1次请求。看到nginx返回的状态码都是201。

(ip地址和信息模糊处理)

状态码201表示“已创建”。NestJS默认状态码是200，但是默认POST的状态码是201。

修复

我们强制让nestjs返回状态码200

@HttpCode(200) @Post() async onWxEvent(@Body('xml') xmlData: IWxMessageXmlData): Promise {}

再尝试一下，看到nginx的log，返回状态码是200了。公众号也正常了。

81.69.1.1 - - [03/Aug/2021:09:53:27 +0800] "POST /mywxserve/?signature=rustfisher×tamp=1627955607&nonce=1829147547&openid=xxx0 HTTP/1.1" 200 0 "-" "Mozilla/4.0"

由此可见，接收微信公众号消息的时候，除了要返回空字符串或者success文本；返回状态码必须是200。

用其他的后台框架可能不会遇到状态码问题。

参考

wx基础消息能力-被动回复用户消息 https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Passive_user_reply_message.html

NestJS controller https://docs.nestjs.com/controllers#status-code

NestJS文章集合 https://rustfisher.com/categories/NestJS/

http状态码 https://rustfisher.com/2021/06/25/Network/http-code/

HTTP Nest Nginx

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。