Python 解析 XML 编码错误的核心是确保解析器接收 Unicode 字符串:应显式指定编码打开文件(如 encoding=’gbk’ 或 ’utf-8-sig’),对 bytes 先解码再解析,避免声明与实际编码冲突,必要时用 lxml.recover=True 容错。

Python 解析 XML 时遇到 编码 错误,通常是因为 XML 声明的编码(如 )与文件实际 字节 流的编码不一致,或文件本身没有正确声明编码、含 BOM、存在非法字节等。核心解决思路是:** 让解析器读取到符合其预期的 Unicode 字符串,而非出错的原始字节 **。
明确指定编码打开文件(推荐)
不要直接用 xml.etree.ElementTree.parse() 传文件路径,而是先以正确编码读取为字符串,再交给解析器处理:
- 若已知文件是 GBK 编码且含
encoding="GBK"声明,用open(……, encoding='gbk')读取后传给ET.fromstring() - 示例:
张三
with open('data.xml', encoding='gbk') as f:
root = ET.fromstring(f.read()) - 对 UTF- 8 带 BOM 的文件,
encoding='utf-8-sig'可自动去除 BOM,避免解析失败
用 bytes 输入并显式解码(适合网络响应或二进制数据)
当拿到的是bytes(如requests.get().content),不要直接传给fromstring(),应先解码:
- 先检查 HTTP 响应头
Content-Type中的 charset,或 XML 内容开头的encoding=……声明 - 用
response.content.decode('gb2312')转为 str,再调用ET.fromstring() - 若声明与实际不符(如声明 UTF- 8 但实际是 GBK),需按真实编码解码,否则会抛
UnicodeDecodeError
捕获并修复常见错误类型
不是所有编码问题都能提前预知,可加一层容错:
立即学习“Python 免费学习笔记(深入)”;
-
UnicodeDecodeError:说明 open 时编码不对,尝试gbk、gb2312、utf-8-sig等常见编码重试 -
ParseError: mismatched tag或unclosed token:很可能是解码后出现乱码导致标签断裂,确认解码方式是否引入了异常字符 - 用
chardet.detect()自动推测编码(仅作参考,不 100% 可靠):import chardet; enc = chardet.detect(content)['encoding']
避免 XML 声明与实际编码冲突
ElementTree 默认依赖 XML 声明中的 encoding 属性来解码——但如果文件是 UTF- 8 却声明encoding="GBK",就会出错。稳妥做法是:
- 手动去掉 XML 声明行(用正则或字符串切片),再用已知正确编码读取
- 或使用
lxml库,它比 标准库 更健壮:from lxml import etree; root = etree.fromstring(content, parser=etree.XMLParser(recover=True)),recover=True可容忍部分编码或格式错误 - 生成 XML 时,统一用 UTF-8 + 无 BOM,并确保声明与实际一致: