微信支付回调必须使用公网HTTPS地址，禁用CSRF和登录校验，严格验签并防重处理，沙箱环境调试，且不保证实时性需主动查单兜底。
回调地址必须能被微信服务器直接访问到
微信支付的异步通知是微信服务器主动向你提供的 URL 发起 POST 请求，不是前端跳转或你主动请求。如果用 localhost、127.0.0.1 或内网地址部署，微信根本连不上，回调必然失败。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 开发阶段用
ngrok http 8000或localtunnel映射出一个公网 HTTPS 地址（微信强制要求回调 URL 是 HTTPS） - Django 的
ALLOWED_HOSTS必须包含该域名，否则 Django 会直接返回 400 - 在微信商户平台配置回调 URL 时，末尾不要带斜杠，比如填
https://abc.ngrok.io/pay/callback/就会 404，应填https://abc.ngrok.io/pay/callback - 确保视图函数不依赖登录态（
@login_required）、CSRF（必须禁用@csrf_exempt），否则微信请求会被拦截
解析微信回调 XML 数据要严格校验签名
微信发来的通知是原始 XML，不是 JSON；而且必须用商户密钥（APIv3 密钥 或旧版 key）验签，否则攻击者可伪造通知篡改订单状态。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
xml.etree.ElementTree.fromstring(request.body)解析，别用第三方 XML 库增加不可控依赖 - 旧版 SDK（v2）用
sign字段 + 所有非空参数按字典序拼接 +key做 MD5；新版（v3）用 HTTP 头里的Wechatpay-Signature和证书验签，必须调用官方wechatpayv3包的Verifier - 验签失败必须返回
<xml><return_code>FAIL</return_code><return_msg>签名失败</return_msg></xml>，且 HTTP 状态码为 200，否则微信会持续重试 - 务必检查
result_code和return_code都是SUCCESS，二者含义不同：前者是通信层，后者是业务层
Django 视图里处理回调要防重复通知
微信不保证只发一次回调，网络抖动时可能几分钟内重发多次。如果每次通知都创建订单、扣库存、发短信，就会造成资损。
python-flask-vue-creator
下载
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用数据库唯一约束防重：例如在订单表加
transaction_id字段并设unique=True，插入前先get_or_create - 收到回调后，先查 DB 是否已存在该
out_trade_no且状态为success，如果是，直接返回成功 XML，不再执行后续逻辑 - 不要在回调里做耗时操作（如调外部 API、发邮件），应写入消息队列（如 Celery）异步处理，避免微信超时（5s 内没响应就认为失败）
- 记录完整原始请求体和响应日志（含时间戳），方便对账排查，但注意脱敏
openid、bank_type等敏感字段
调试时用沙箱环境 + 微信官方校验工具
线上环境回调失败很难定位，微信又不提供详细错误日志。沙箱和校验工具是唯二靠谱的调试手段。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在商户平台开启「沙箱环境」，获取沙箱
key和测试用的appid/mch_id，所有接口（包括回调）都走沙箱域名https://api.mch.weixin.qq.com/sandboxnew/... - 用微信提供的「回调校验工具」（路径：商户平台 → 开发配置 → 回调配置页底部）上传你的回调 URL 和证书，它会模拟发一次通知并告诉你验签是否通过
- 本地调试时，在视图开头加
print(request.body.decode())并用curl -X POST -d @test_xml.txt模拟请求，比等微信触发快得多 - 注意沙箱回调的
sign是用沙箱key算的，和正式环境 key 不同，别混用
最易忽略的是：微信回调通知里不带用户 openid（除非是 JSAPI 支付且配置了授权），也**不保证实时性**——高峰期延迟可达数分钟。别拿它当实时交易完成信号去解锁资源，得结合主动查单（orderquery）兜底。
