Khi API nhận dữ liệu xấu — giá khuyến mãi cao hơn giá gốc, ngày kết thúc trước ngày bắt đầu — lỗi phải bị chặn ngay ở Serializer, trước khi chạm tới database. Django REST Framework cho sẵn hai móc: validate_<field> để kiểm tra từng trường riêng lẻ, và validate() để kiểm tra quan hệ giữa nhiều trường. Dùng đúng hai móc này, view chỉ còn một dòng is_valid(raise_exception=True) và client luôn nhận lỗi 400 gắn đúng field.

Vấn đề

Nhiều dự án validate bằng một loạt if ngay trong view: kiểm tra giá ở create(), kiểm tra ngày ở update(), rồi copy-paste sang view khác. Ba cái hại: logic kiểm tra nằm rải rác nên sửa một rule phải sờ nhiều chỗ, dữ liệu xấu lọt xuống database rồi nổ thành 500 thay vì 400, và lỗi không gắn với field nào nên frontend khó hiển thị đúng ô nhập.

Một lỗi khác: viết validate_<field> nhưng quên return value. DRF lấy giá trị trả về — tức None — làm giá trị field, dữ liệu đúng bỗng thành None mà không báo lỗi gì.

# Cách làm dễ sai: validate bằng if trong view, lặp lại ở mọi view
def create(self, request):
price = request.data.get("price")
discount = request.data.get("discount_price")
if discount and discount > price:
return Response(
{"error": "Giá khuyến mãi không được lớn hơn giá gốc."},
status=status.HTTP_400_BAD_REQUEST,
)
# ... rồi lại lặp lại đoạn này ở update()

Giải pháp

Đưa mọi quy tắc vào Serializer, ví dụ một khóa học có giá gốc, giá khuyến mãi và khoảng ngày học:

from rest_framework import serializers
from .models import Course
class CourseSerializer(serializers.ModelSerializer):
class Meta:
model = Course
fields = ["id", "name", "price", "discount_price",
"start_date", "end_date"]
read_only_fields = ["id"]
extra_kwargs = {"price": {"min_value": 0}}
def validate_name(self, value):
value = value.strip()
if len(value) < 3:
raise serializers.ValidationError(
"Tên khóa học phải có ít nhất 3 ký tự.")
return value
def validate_discount_price(self, value):
if value is not None and value < 0:
raise serializers.ValidationError(
"Giá khuyến mãi không được âm.")
return value
def validate(self, data):
price = data.get("price")
discount = data.get("discount_price")
if (price is not None and discount is not None
and discount > price):
raise serializers.ValidationError(
{"discount_price":
"Giá khuyến mãi không được lớn hơn giá gốc."})
start = data.get("start_date")
end = data.get("end_date")
if start is not None and end is not None and end <= start:
raise serializers.ValidationError(
{"end_date": "Ngày kết thúc phải sau ngày bắt đầu."})
return data

Ba điểm cần nhớ. Thứ nhất, validate_<field> nhận giá trị đã qua kiểm tra kiểu và bắt buộc phải trả về value — quên return là field thành None. Thứ hai, validate() chạy sau mọi kiểm tra theo field, field nào lỗi thì vắng mặt trong data — nên dùng data.get() thay vì data[...]. Thứ ba, raise ValidationError với một dict thì lỗi gắn đúng tên field; raise chuỗi trần thì lỗi rơi vào non_field_errors.

Trong view chỉ còn một dòng, DRF tự trả 400 kèm JSON lỗi:

serializer = CourseSerializer(data=request.data)
serializer.is_valid(raise_exception=True)
serializer.save()

Gửi discount_price lớn hơn price, client nhận ngay {"discount_price": ["Giá khuyến mãi không được lớn hơn giá gốc."]} kèm status 400 — không cần thêm code xử lý lỗi trong view.

Áp dụng vào dự án của bạn

Chuyển các if kiểm tra dữ liệu trong view vào Serializer: rule một field thì viết validate_<field>, rule nhiều field thì viết validate(). Như vậy mọi luật validate nằm ở một nơi duy nhất — thêm field hay đổi rule chỉ sửa một chỗ, mọi endpoint dùng chung Serializer đều hưởng luật mới ngay.

Bài viết liên quan

Câu hỏi thường gặp

validate_<field> chạy trước hay validate() chạy trước?

validate_<field> chạy trước, sau khi field đã qua kiểm tra kiểu và ràng buộc như min_value. validate() chạy cuối cùng, với data chỉ chứa các field đã hợp lệ. Vì vậy trong validate() hãy dùng data.get("price") thay vì data["price"] để tránh KeyError khi price đã lỗi.

Quên return value trong validate_<field> thì sao?

DRF lấy giá trị hàm trả về làm giá trị mới của field, nên quên return value là field bị ghi đè thành None trong im lặng. Hãy coi return value là dòng bắt buộc cuối mỗi validate_<field>.

Nên validate ở Serializer hay ở model?

Validate input API thì đặt ở Serializer — lớp tiếp xúc trực tiếp với dữ liệu client và trả lỗi 400 đúng chuẩn. clean() của model phù hợp với rule nghiệp vụ dùng chung nhiều nơi — tạo bản ghi từ admin, shell hay script import — nơi không đi qua Serializer.

ValidationError nên raise chuỗi hay dict?

Raise dict khi lỗi thuộc về một field cụ thể, ví dụ {"discount_price": "..."} — client biết chính xác ô nào sai. Chỉ raise chuỗi khi lỗi thuộc về toàn bộ dữ liệu, lúc đó lỗi nằm trong non_field_errors.

💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.

Nguồn tham khảo