跳轉至

建立 2026-10-11 更新 2026-10-11

驗證與序列化

驗證與序列化分類處理資料的「進」與「出」:資料進來時,用自訂驗證器檢查型別以外的商業規則,並正確處理 ValidationError;資料出去時,用 model_dump 控制輸出的欄位與格式;遇到多層 JSON 時,用巢狀模型一次驗證整棵資料樹。

頁面 重點
自訂驗證器 @field_validator、@model_validator、@computed_field
ValidationError 錯誤處理 讀懂錯誤結構、轉成 API 回應、自訂錯誤訊息
序列化與輸出 model_dump、model_dump_json、include/exclude、自訂序列化
巢狀模型 模型包模型、串列中的模型、遞迴結構、Discriminated Union

讀完 入門基礎 後再看這裡最順。