Flask如何解析XML_接收微信公众号事件推送XML格式请求

P粉602998670

P粉602998670

2026-04-12

602人浏览

原创

flask需用request.get_data()获取微信xml原始数据,因默认解析器不支持text/xml;须用defusedxml安全解析防xxe攻击;提取字段用root.findtext()避免异常;本地调试需公网https且注意幂等处理。

flask如何解析xml_接收微信公众号事件推送xml格式请求

Flask怎么拿到微信发来的XML原始数据

微信公众号事件推送(如关注、点击菜单、扫码等)是用 POST 请求发送 XML 数据,但 Flask 默认的 request.formrequest.json 都解析不了它——前者只认 application/x-www-form-urlencoded,后者只认 application/json,而微信发的是 text/xmlapplication/xml

必须手动读取原始请求体:

  • request.get_data() 是最直接的方式,返回 bytes,需解码为字符串再解析
  • 不能用 request.data 之后又调 request.form —— Flask 的底层会把 body 读一次就清空,重复读会得到空值
  • 微信服务器要求 5 秒内响应,所以解析要快,别在路由里做耗时 XML 校验或网络请求

示例:

from flask import Flask, request
app = Flask(__name__)
<p>@app.route('/wechat', methods=['POST'])
def wechat():
xml_data = request.get_data()  # ← 关键:拿原始 bytes
if not xml_data:
return 'fail', 400
xml_str = xml_data.decode('utf-8')  # 微信固定用 UTF-8</p><h1>后续用 xml.etree.ElementTree 或 defusedxml 解析</h1>

用什么库安全解析微信 XML,避免 XXE 攻击

微信 XML 是外部不可信输入,直接用 Python 内置的 xml.etree.ElementTree.fromstring() 有 XXE(XML External Entity)风险,攻击者可能构造恶意 XML 读取服务器本地文件或发起内网请求。

必须换更安全的替代方案:

微信公众平台开发入门教程 中文WORD版
微信公众平台开发入门教程 中文WORD版

由于微信的大热,为了更好的方便使用微信的用户查询一些信息,这篇文章是入门级的微信公众平台开发教程,需要的朋友可以参考下 这篇入门教程将引导你完成如下任务: 创建百度云平台应用启用微信公众平台开发模式获取订阅、文字、图片、语音、视频消息回复文本、图文及音乐消息程序开发

下载
  • 优先用 defusedxml.ElementTree.fromstring(),它是专为防御 XXE 设计的 xml.etree.ElementTree 替代品
  • 不要用 minidomlxml(除非显式禁用外部实体),它们默认开启 DTD 解析
  • 如果坚持用标准库,得手动配置 parser:xml.etree.ElementTree.XMLParser(resolve_entities=False),但不如 defusedxml 省心

安装与用法:

pip install defusedxml
# ……
from defusedxml.ElementTree import fromstring
root = fromstring(xml_str)  # 安全解析

怎么提取微信 XML 里的 ToUserName、Event 这些字段

微信事件 XML 结构固定,顶层是 <xml></xml>,子节点全是直系文本节点(没有嵌套层级),比如 <tousername>gh_xxx</tousername>。直接用 .findtext() 最简单可靠。

  • root.findtext('ToUserName') 返回字符串,找不到返回 None,适合判空
  • 别用 root.find('ToUserName').text —— 如果节点不存在,.find() 返回 None,再点 .text 就抛 AttributeError
  • 注意大小写:微信字段名严格区分大小写,EventKey 不是 eventkeyMsgType 不是 msgtype
  • 文本内容可能含 CDATA,defusedxml 会自动解包,不用额外处理

常用字段提取示例:

to_user = root.findtext('ToUserName')
from_user = root.findtext('FromUserName')
msg_type = root.findtext('MsgType')  # 'event' 或 'text'
event = root.findtext('Event')       # 'subscribe' / 'CLICK' / 'SCAN'
event_key = root.findtext('EventKey')  # 菜单 key 或扫码参数

为什么本地调试收不到微信 XML,或者解析出空值

本地开发时常见现象:微信后台提示“请求 URL 超时”或“配置失败”,或者 Flask 日志里 request.get_data() 返回空 bytes。根本原因不是代码错,而是环境链路问题。

  • 微信服务器只支持公网可访问的 HTTPS URL,http://localhost:5000 或内网 IP 必然失败,必须用 ngroklocaltunnel 或真实域名 + SSL 证书
  • Flask 默认不处理 Content-Type: text/xml 的请求头,但不影响 request.get_data() 读 body;真正影响的是反向代理(如 Nginx)可能截断或转义 XML —— 检查代理配置是否加了 proxy_set_header Content-Type text/xml;
  • 微信会在首次配置 URL 时 GET 请求校验 token,但事件推送一定是 POST;别把两个逻辑混在一起处理,否则 POST 时因没匹配到路由返回 405
  • 微信有时会重试失败推送,导致同一事件收到多次,业务层要做幂等(比如用 MsgId 去重)

调试建议:用微信开发者工具「接口调试」功能,手动 POST XML 到你的地址,比等真实事件更快定位问题。

相关文章

微信app下载
微信app下载

微信是一款手机通信软件,支持通过手机网络发送语音短信、视频、图片和文字。微信可以单聊及群聊,还能根据地理位置找到附近的人,带给大家全新的移动沟通体验,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

微信 微信公众号

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1104

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

2049

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1185

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

8664

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1456

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1528

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

880

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

530

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1108

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP开发微信公众号平台从简到精
PHP开发微信公众号平台从简到精

共25课时 | 6.5万人学习

PHP开发微信公众号视频教程
PHP开发微信公众号视频教程

共5课时 | 1.7万人学习

PHP开发微信公众号视频教程
PHP开发微信公众号视频教程

共13课时 | 5.7万人学习