Python Pydantic如何用于校验解析后的XML数据

在Python开发中，处理XML格式数据并校验其合法性是常见需求，Pydantic作为专注于数据校验和类型管理的库，能够大幅简化这一流程。通过先将XML数据解析为字典结构，再适配到Pydantic模型，就可以利用Pydantic的内置校验能力完成数据验证。

前置准备

首先需要安装必要的依赖库，xmltodict用于解析XML为字典，pydantic用于数据校验，执行以下命令安装：

pip install xmltodict pydantic

核心实现步骤

1. 解析XML为字典

使用xmltodict库的parse方法可以将XML字符串转换为Python字典，这是衔接XML解析和Pydantic校验的关键步骤。示例如下：

import xmltodict

# 待解析的XML数据
xml_data = """
<user>
    <id>1001</id>
    <name>张三</name>
    <age>25</age>
    <email>test@ipipp.com</email>
</user>
"""

# 解析XML为字典
parsed_dict = xmltodict.parse(xml_data)
print(parsed_dict)
# 输出：{'user': {'id': '1001', 'name': '张三', 'age': '25', 'email': 'test@ipipp.com'}}

2. 定义Pydantic校验模型

根据XML解析后的字典结构，定义对应的Pydantic模型，指定字段类型、约束条件，比如id为正整数、age在合理范围等：

from pydantic import BaseModel, field_validator, EmailStr, PositiveInt
from typing import Optional

class UserModel(BaseModel):
    id: PositiveInt  # 正整数约束
    name: str
    age: int
    email: EmailStr  # 邮箱格式校验

    @field_validator('age')
    def check_age(cls, v):
        if v < 0 or v > 120:
            raise ValueError('年龄必须在0到120之间')
        return v

3. 适配数据并完成校验

xmltodict解析后的字典外层会包含根节点，需要先提取对应层级的字典，再传入Pydantic模型完成校验：

# 提取user节点对应的字典
user_dict = parsed_dict.get('user', {})

# 转换字段类型，xmltodict解析出的数字默认是字符串，需要转为对应类型
user_dict['id'] = int(user_dict['id'])
user_dict['age'] = int(user_dict['age'])

# 传入Pydantic模型校验
try:
    user_obj = UserModel(**user_dict)
    print('数据校验通过，模型实例：', user_obj)
except Exception as e:
    print('数据校验失败：', e)

复杂XML结构处理

如果XML包含嵌套结构或者重复节点，处理方式也类似，只需要定义嵌套的Pydantic模型即可。比如XML包含多个订单项：

<order>
    <order_id>202401</order_id>
    <items>
        <item>
            <name>笔记本</name>
            <price>3999</price>
        </item>
        <item>
            <name>鼠标</name>
            <price>199</price>
        </item>
    </items>
</order>

对应的Pydantic模型和校验代码如下：

from pydantic import BaseModel
from typing import List

class ItemModel(BaseModel):
    name: str
    price: float

class OrderModel(BaseModel):
    order_id: str
    items: List[ItemModel]  # 嵌套的列表结构

# 解析XML
order_xml = """
<order>
    <order_id>202401</order_id>
    <items>
        <item>
            <name>笔记本</name>
            <price>3999</price>
        </item>
        <item>
            <name>鼠标</name>
            <price>199</price>
        </item>
    </items>
</order>
"""
order_dict = xmltodict.parse(order_xml).get('order', {})

# xmltodict解析重复节点时，单个节点是字典，多个节点是列表，需要统一处理
items = order_dict.get('items', {}).get('item', [])
if not isinstance(items, list):
    items = [items]
# 转换price为float
for item in items:
    item['price'] = float(item['price'])
order_dict['items'] = items

# 校验
order_obj = OrderModel(**order_dict)
print('订单校验通过：', order_obj)

常见问题说明

• xmltodict解析出的所有值默认都是字符串，传入Pydantic模型前需要根据字段类型做转换，否则会触发类型校验错误。
• 如果XML中存在空节点，xmltodict会解析为None，Pydantic模型中对应的字段需要设置为Optional类型，避免校验失败。
• 当XML有命名空间时，xmltodict解析出的键会包含命名空间前缀，定义Pydantic模型时需要和解析后的键名保持一致。

使用Pydantic校验XML解析数据的核心思路是先将XML转换为结构化的字典，再对齐Pydantic模型的字段定义，借助Pydantic的类型约束和自定义校验规则完成数据合法性验证，相比手动写校验逻辑更加简洁且易维护。

PydanticXML解析数据校验PythonXML_to_dict修改时间：2026-07-24 02:30:40