如何序列化DRF中ManyToManyField的through中间模型？

问题原因 #

你遇到的错误本质是：DRF默认会把Album模型里的多对多字段tracks解析为关联的Track实例集合，但你用的AlbumTrackSerializer是针对AlbumTrack中间表模型的，用它序列化Track实例自然会报错——因为Track没有track这个属性（你的序列化器里用了source='track.pk'，但当前实例是Track，不是AlbumTrack）。

解决方案 #

核心思路是：不要直接用多对多字段tracks，而是通过Album与AlbumTrack的反向关联来获取中间表实例，再用AlbumTrackSerializer序列化。

方案1：使用默认反向关联字段（无需修改模型） #

修改AlbumSerializer，将tracks字段的数据源指向Album的反向关联字段albumtrack_set（这是Django ForeignKey反向关联的默认命名规则：小写模型名+_set）：

class AlbumSerializer(serializers.ModelSerializer):
    # 用source指定从反向关联的AlbumTrack集合取数据
    tracks = AlbumTrackSerializer(source='albumtrack_set', many=True)

    class Meta:
        model = Album
        fields = ('title', 'tracks')

方案2：自定义反向关联名称（更直观） #

如果觉得albumtrack_set不够直观，可以给AlbumTrack的album字段添加related_name，然后在序列化器里使用这个名称：

1. 修改模型：

class AlbumTrack(models.Model):
    # 添加related_name，方便反向查询
    album = models.ForeignKey(Album, on_delete=models.CASCADE, related_name='album_tracks')
    track = models.ForeignKey(Track, on_delete=models.CASCADE)
    score = models.PositiveIntegerField(default=0)

    class Meta:
        unique_together = ('album', 'track')

    def __str__(self):
        return f"{self.album.title} - {self.track.title} ({self.score})"

2. 修改序列化器：

class AlbumSerializer(serializers.ModelSerializer):
    tracks = AlbumTrackSerializer(source='album_tracks', many=True)

    class Meta:
        model = Album
        fields = ('title', 'tracks')

可选优化：简化序列化器结构 #

你当前的AlbumTrackSerializer手动拼接track字段的方式可以简化，用嵌套序列化器更规范：

# 先定义Track的基础序列化器
class TrackSerializer(serializers.ModelSerializer):
    class Meta:
        model = Track
        fields = ('id', 'title')

# 再修改AlbumTrackSerializer
class AlbumTrackSerializer(serializers.ModelSerializer):
    track = TrackSerializer()

    class Meta:
        model = AlbumTrack
        fields = ('track', 'score')

这样返回的接口数据结构会更清晰，示例如下：

{
  "title": "示例专辑",
  "tracks": [
    {
      "track": {
        "id": 1,
        "title": "示例曲目1"
      },
      "score": 90
    }
  ]
}

内容的提问来源于stack exchange，提问作者Vasya Pupkin