微信signature校验需手动实现,关键参数为signature、timestamp、nonce、echostr;timestamp和nonce须从request.get正确获取,三者字典序拼接后utf-8编码sha1比对,echostr原样返回;django视图须@csrf_exempt且路由路径与公众号后台url严格一致;token应统一配置于settings.py,避免硬编码;时间差超5分钟会导致校验失败。

微信服务器GET请求的Signature校验必须手动实现,不能只靠SDK封装
很多开发者误以为装了 wechatpy 就能自动完成接入验证,结果提交配置时一直提示“token验证失败”。问题往往出在:校验逻辑没跑通,或者参数取错了。
微信服务器发来的GET请求带四个关键参数:signature、timestamp、nonce、echostr。其中前三个要参与SHA1签名比对,echostr 是唯一需要原样返回的字符串。
-
timestamp和nonce必须从request.GET中直接获取,不能用request.GET.get("nonece")(拼写错误)或request.data(POST专用) - 排序必须是字典序(
sort()),不是时间序或数值大小序;三者拼接前不能加空格、换行或分隔符 - 拼接字符串必须统一编码为
utf-8,否则hashlib.sha1()计算结果不一致 - 如果用了
wechatpy.utils.check_signature,注意它不处理echostr返回逻辑,你仍需手动return HttpResponse(echostr)
Django视图必须禁用CSRF,且路由路径要和公众号后台URL完全一致
微信服务器不会携带cookie或CSRF token发起请求,Django默认中间件会直接拦截并返回403。不加 @csrf_exempt,校验永远过不去。
另外,公众号后台填的URL(如 http://xxx.com/wx/)必须和 urls.py 中定义的路由路径严格匹配,包括末尾斜杠。
Go语言(Golang)1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口,版本号 1.26.0,可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 若后台填的是
http://xxx.com/wx,路由应写path('wx', ...),而非path('wx/', ...)(Django 3+默认启用APPEND_SLASH=True,但微信不自动补) - 使用
path()时,推荐显式写path('wx/', ...)并在后台URL末尾加/,避免歧义 -
@csrf_exempt必须加在视图函数上,不能只加在类视图的某个方法里(如仅加在get()上,POST仍会被拦)
POST请求中的XML body解析容易因编码或格式异常失败
用户消息以XML格式通过POST发来,Django默认将 request.body 当作 bytes 处理,但 wechatpy.parse_message 要求输入是 bytes —— 看似简单,实则几个坑卡住90%的人:
- 不要对
request.body做.decode('utf-8')再传给parse_message,它内部会自行解码;手动 decode 可能破坏原始XML结构(比如含CDATA段时) - 确保 Nginx/Apache 没有篡改请求体(如开启 gzip 后未正确解压、body size 限制太小导致截断)
- 如果收到空
msg或抛ParseError,先打印request.body[:200]看是否为合法XML开头(b'<xml>'</xml>);常见原因是反向代理丢掉了原始 content-type(应为text/xml或application/xml) - 用
create_reply(..., message=msg)时,message参数不可省略,否则生成的XML缺少ToUserName/FromUserName字段,微信拒绝接收
Token值必须全局一致,且不能硬编码在视图里
Token是你在微信后台“基本配置”里填的那个字符串,它同时用于签名计算和服务端校验。一旦不一致,signature 永远对不上。
硬编码在视图函数中看似方便,但会导致后续无法切换环境(开发/测试/生产)、无法做配置中心管理、Git泄露风险高。
- 应统一放在
settings.py中,如WECHAT_TOKEN = 'your_real_token_here' - 视图中通过
from django.conf import settings引入,调用settings.WECHAT_TOKEN - 若用
wechatpy.utils.check_signature,第一个参数就是这个 token,别错传成空字符串或变量名字符串(如'settings.WECHAT_TOKEN') - 本地调试时,可临时在
settings.py加print(settings.WECHAT_TOKEN)确认加载无误
timestamp 和服务器时间差超过5分钟即校验失败;别只盯着代码逻辑,先确认你的云服务器系统时间是否已用 ntpdate 或 systemd-timesyncd 同步。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










