Làm thế nào để viết validation tùy chỉnh trong Pydantic?

Question

Accepted Answer

Ngoài các ràng buộc tích hợp sẵn, Pydantic cho phép bạn viết **logic validation tùy chỉnh** với field validator (validate một field) và model validator (validate trên nhiều field) — cho các quy tắc mà ràng buộc đơn giản không thể diễn đạt. (Cú pháp được trình bày là Pydantic v2.)

## Field validator — validate/biến đổi một field đơn lẻ

```python
from pydantic import BaseModel, field_validator

class User(BaseModel):
    username: str
    password: str

@field_validator("username")
    @classmethod
    def username_alphanumeric(cls, v: str) -> str:
        if not v.isalnum():
            raise ValueError("username must be alphanumeric")   # → một lỗi 422
        return v.lower()                                         # cũng có thể BIẾN ĐỔI giá trị
```

Một `@field_validator` chạy logic tùy chỉnh trên một field: raise `ValueError` để từ chối input không hợp lệ (FastAPI chuyển nó thành một lỗi 422 rõ ràng), hoặc trả về một giá trị đã biến đổi (ví dụ chuẩn hóa về chữ thường).

## Model validator — validation đa field

```python
from pydantic import model_validator

class SignupForm(BaseModel):
    password: str
    confirm_password: str

@model_validator(mode="after")
    def passwords_match(self):
        if self.password != self.confirm_password:    # so sánh NHIỀU field
            raise ValueError("passwords do not match")
        return self
```

Một `@model_validator(mode="after")` chạy sau khi tất cả field được validate, với quyền truy cập toàn bộ model — dùng cho các quy tắc liên quan **nhiều field** (ví dụ xác nhận password khớp, hoặc ngày bắt đầu trước ngày kết thúc).

## Validation tích hợp thường đủ trước

```python
class Product(BaseModel):
    price: float = Field(gt=0)          # dùng ràng buộc Field cho quy tắc đơn giản
    sku: str = Field(pattern=r"^[A-Z]{3}-\d+$")
    email: EmailStr                      # kiểu chuyên biệt cho định dạng
# chỉ dùng validator tùy chỉnh khi ràng buộc/kiểu không thể diễn đạt quy tắc
```

Ưu tiên ràng buộc `Field` và kiểu chuyên biệt cho quy tắc đơn giản; dùng validator tùy chỉnh cho logic nghiệp vụ thực sự.

## Tại sao điều này quan trọng

Validation Pydantic tùy chỉnh quan trọng để thực thi các quy tắc nghiệp vụ vượt ra ngoài kiểm tra kiểu và ràng buộc đơn giản — và vì validation then chốt cho **bảo mật và toàn vẹn dữ liệu**, khả năng diễn đạt bất kỳ quy tắc nào là có giá trị. **Field validator** xử lý logic một-field (kiểm tra định dạng tùy chỉnh, chuẩn hóa/biến đổi), trong khi **model validator** xử lý nhu cầu phổ biến về **validation đa field** (password khớp, khoảng ngày, yêu cầu có điều kiện) mà quy tắc cấp field không thể diễn đạt.

Các validator tích hợp liền mạch với FastAPI — một `ValueError` được raise trở thành một response 422 rõ ràng tự động.

Hiểu khi nào dùng ràng buộc/kiểu tích hợp (cho quy tắc đơn giản) so với validator tùy chỉnh (cho logic nghiệp vụ thực sự), và field validator khác model validator thế nào, cho phép bạn đảm bảo dữ liệu đến thỏa mãn đầy đủ yêu cầu của ứng dụng, biến đây thành kiến thức quan trọng để xây dựng API bền vững, đúng đắn.