Django DRF通过ForeignKey获取关联对象无返回值问题排查

问题原因 #

核心错误是序列化器嵌套字段的名称与模型外键的反向关联名（related_name）不匹配，DRF找不到对应关联数据时会静默忽略该只读字段，所以返回结果没有playersquadra字段也不会报错。

你在PlayerSquadra模型中，指向Squadra的外键设置的related_name为squadra_squadraplayer，这是从Squadra侧反向查询关联的PlayerSquadra记录时的唯一属性名，但你在SquadraSerializer中定义的嵌套字段名为playersquadra，二者不一致导致无法读取关联数据。

修复方案 #

两种方案二选一即可：

方案1：修改序列化器字段名（无需修改数据库） #

把序列化器中的嵌套字段名调整为和related_name一致：

class SquadraSerializer(serializers.ModelSerializer):
    # 字段名与模型的related_name保持一致
    squadra_squadraplayer = PlayerSquadraSerializer(many=True, read_only=True)

    class Meta:
        model = Squadra
        fields = ['nomeSquadra','id','squadra_squadraplayer']

方案2：修改模型的反向关联名（需要执行数据库迁移） #

把PlayerSquadra模型中squadra外键的related_name调整为和序列化器字段名一致：

squadra = models.ForeignKey(
    'app_stagione.Squadra',
    on_delete=models.CASCADE,
    verbose_name=_('squadra'),
    related_name='playersquadra'
)

修改后执行python manage.py makemigrations和python manage.py migrate完成迁移即可。

通用排查思路 #

遇到同类嵌套序列化无返回的问题可以按以下步骤自查：

1. 先核对外键的related_name与序列化器嵌套字段名是否完全一致，拼写、大小写都要匹配
2. 在Django Shell中直接执行反向查询，确认目标记录确实存在关联数据：

from app_stagione.models import Squadra
# 替换为你要查询的ID
squadra = Squadra.objects.get(id=26)
# 替换为你的related_name，打印结果看是否为空
print(squadra.squadra_squadraplayer.all())

3. 检查序列化器的fields列表是否已包含嵌套字段，漏写的话不会返回
4. 如果需要直接返回球员的详情而非中间表PlayerSquadra的字段，可以在PlayerSquadraSerializer中再嵌套一层PlayerSerializer，或者通过source参数直接指定关联到Player模型的字段。

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