Pydantic根校验器：构建跨字段验证系统

---

title: Pydantic根校验器：构建跨字段验证系统
date: 2025/3/24
updated: 2025/3/24
author: cmdragon

excerpt:
Pydantic根校验器支持预处理(pre)与后处理(post)模式，可访问全量字段数据并修改值字典。多字段关联验证实现业务规则检查，如航班时间顺序与保险策略联动。分阶段验证流程通过pre校验器拆分复杂校验步骤。企业级应用包含分布式事务余额验证及动态策略加载，集成外部服务与策略模式。递归校验器处理树状结构数据查重，异步校验实现网络资源可用性检测。校验顺序控制采用skip_on_failure确保阶段隔离，缓存机制优化高频校验性能。错误处理需关注字段存在性检查与异步资源管理，推荐使用pre校验器拆分循环依赖，遵循"单一出口"原则构建模块化验证管道。

categories:

• 后端开发
• FastAPI

tags:

• Pydantic根校验器
• 跨字段验证
• 业务流程验证
• 多阶段校验
• 校验依赖管理
• 企业级验证策略
• 验证逻辑解耦

---

扫描二维码关注或者微信搜一搜：编程智域 前端至全栈交流与成长

探索数千个预构建的 AI 应用，开启你的下一个伟大创意

第一章：根校验器基础

1.1 核心工作机制

from pydantic import BaseModel, root_validator


class OrderValidator(BaseModel):
    price: float
    quantity: int
    total: float

    @root_validator(pre=True)
    def calculate_total(cls, values):
        if "price" in values and "quantity" in values:
            values["total"] = values["price"] * values["quantity"]
        return values


# 自动计算总价
print(OrderValidator(price=9.99, quantity=3).total)  # 29.97

根校验器特性：

• 可访问所有字段值
• 支持pre/post两种模式
• 可修改整个values字典
• 支持多层级校验流程

---

第二章：复杂业务规则

2.1 多字段关联验证

class FlightBooking(BaseModel):
    departure: datetime
    arrival: datetime
    passengers: int

    @root_validator
    def check_flight_rules(cls, values):
        if values["arrival"] <= values["departure"]:
            raise ValueError("到达时间必须晚于出发时间")

        if values["passengers"] > 6:
            values["insurance"