Quan hệ ManyToMany mặc định của Django chỉ lưu cặp khóa ngoại, không có chỗ cho dữ liệu riêng của chính mối quan hệ. Khi cần lưu thêm ngày đăng ký, điểm số hay vai trò, hãy khai báo một model trung gian (through model) và trỏ ManyToManyField tới nó qua tham số through. Cách này giữ nguyên API quen thuộc của quan hệ nhiều–nhiều, đồng thời cho bạn một model thật để truy vấn.

Vấn đề

Ví dụ trang khóa học: một học viên đăng ký nhiều khóa, một khóa có nhiều học viên — đúng kiểu ManyToMany. Nhưng bạn còn muốn biết học viên đăng ký khi nào và đạt điểm bao nhiêu. Bảng trung gian do Django tự tạo chỉ có hai cột khóa ngoại, không có chỗ cho ngày đăng ký hay điểm số. Nhét điểm vào model Student thì sai, vì điểm thuộc về từng cặp học viên–khóa học, không thuộc riêng học viên.

class Student(models.Model):
name = models.CharField(max_length=100)
class Course(models.Model):
title = models.CharField(max_length=200)
students = models.ManyToManyField(Student)

Đoạn code trên chạy tốt, nhưng course.students.add(student) chỉ tạo được liên kết “trơ trụi” — không lưu được ngày đăng ký hay điểm số.

Giải pháp

Khai báo model Enrollment làm bảng trung gian, rồi trỏ ManyToManyField tới nó qua tham số through:

class Enrollment(models.Model):
student = models.ForeignKey(Student, on_delete=models.CASCADE)
course = models.ForeignKey(Course, on_delete=models.CASCADE)
enrolled_at = models.DateTimeField(auto_now_add=True)
grade = models.FloatField(null=True, blank=True)
class Meta:
unique_together = [["student", "course"]]
class Course(models.Model):
title = models.CharField(max_length=200)
students = models.ManyToManyField(Student, through="Enrollment")

Nên thêm unique_together trên cặp khóa ngoại — một học viên không thể đăng ký cùng một khóa hai lần, và ràng buộc này chặn trùng lặp ngay ở tầng database.

Tạo liên kết có kèm dữ liệu phụ bằng through_defaults, hoặc tạo trực tiếp qua model trung gian:

course.students.add(student, through_defaults={"grade": 8.5})
# tường minh hơn khi cần set nhiều trường:
Enrollment.objects.create(student=student, course=course, grade=8.5)

Truy vấn ngược lại cũng đi qua through model, dùng tên model viết thường làm tên quan hệ:

# các lượt đăng ký đạt điểm giỏi của một khóa
course.enrollment_set.filter(grade__gte=8)
# học viên đạt điểm 9 trở lên ở khóa này
Student.objects.filter(enrollment__course=course, enrollment__grade__gte=9)

API ManyToMany quen thuộc vẫn nguyên vẹn: course.students.all(), student.course_set.all() và prefetch_related("students") đều chạy như trước — through model chỉ thêm dữ liệu, không lấy đi tính năng nào.

Lưu ý: nếu trường phụ bắt buộc mà không có mặc định, .add() không kèm through_defaults sẽ lỗi IntegrityError. Khi đó tạo trực tiếp qua Enrollment.objects.create() cho rõ ràng. Nếu through model có hai khóa ngoại cùng trỏ về một model, khai báo thêm through_fields để Django biết cặp khóa ngoại nào tạo nên quan hệ.

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

Quy tắc rất đơn giản: dữ liệu thuộc về cặp quan hệ thì đặt vào through model, dữ liệu thuộc về một đầu thì đặt vào model của đầu đó. Đơn hàng và sản phẩm là ví dụ kinh điển — OrderItem lưu số lượng và giá tại thời điểm mua, vì giá sản phẩm có thể đổi nhưng hóa đơn cũ không được đổi theo. Tương tự, thành viên trong nhóm nên đi qua Membership để lưu vai trò và ngày tham gia. Mỗi khi định “nhét tạm” một trường vào model, hãy hỏi: trường này mô tả đối tượng, hay mô tả mối quan hệ?

Bài viết liên quan

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

Dùng through model rồi thì `.add()` còn dùng được không?

Được, miễn là các trường phụ có mặc định hoặc bạn truyền through_defaults={...}. Nếu trường phụ bắt buộc mà không có mặc định, .add() sẽ lỗi — lúc đó tạo trực tiếp qua through model.

Bảng trung gian cũ có dữ liệu rồi, đổi sang through model thì sao?

Đổi sang through model sẽ tạo bảng mới. Nếu dữ liệu cũ quan trọng, viết data migration copy dữ liệu từ bảng cũ sang bảng mới rồi mới xóa bảng cũ. Trên dự án mới thì cứ khai báo through model ngay từ đầu.

Khi nào không nên dùng through model?

Khi quan hệ chỉ cần lưu cặp khóa ngoại và không có dữ liệu riêng, ManyToMany mặc định gọn hơn — Django tự tạo bảng trung gian ẩn và bạn không phải viết thêm model. Chỉ thêm through model khi mối quan hệ thật sự mang dữ liệu của riêng nó.

💬 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