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 viewdef 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 serializersfrom .models import Courseclass 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
- Django REST Framework: viết Serializer đúng cách — ModelSerializer, depth và SerializerMethodField
- FastAPI: validate dữ liệu đầu vào chuẩn chỉnh bằng Pydantic Field và validator tùy chỉnh
- Django REST Framework: phân quyền và chống spam API bằng Permission + Throttling trong 5 phút
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
- Tài liệu Django REST Framework — Serializers: Validation: https://www.django-rest-framework.org/api-guide/serializers/#validation
- Tài liệu Django REST Framework — Fields: https://www.django-rest-framework.org/api-guide/fields/
