Django ModelViewSet中SerializerMethodField未调用问题求助

核心问题排查 #

你遇到的两个现象（自定义字段不显示、fields修改无效）本质上指向同一个核心：序列化器未被正确执行，或者执行过程中出现了未捕获的异常。下面是分步解决方法：

1. 先解决fields修改无效的问题 #

这说明你的RiskSerializer可能根本没被视图集加载，先做以下检查：

• 确认RiskViewSet中的serializer_class是否正确导入了RiskSerializer，有没有拼写错误或者导入路径错误（比如误导入了其他模块的同名序列化器）。
• 检查项目中是否有其他地方重写了get_serializer_class方法，导致实际使用的不是你定义的序列化器。

2. 修复SerializerMethodField不生效的问题 #

自定义字段不显示，大概率是执行get_audio_url/get_pictogramme_url时抛出了异常，导致字段被静默跳过。修改序列化器的方法，增加空值判断：

class RiskSerializer(serializers.ModelSerializer):
    """Risk序列化器"""
    
    audio_url = serializers.SerializerMethodField()
    pictogramme_url = serializers.SerializerMethodField()

    class Meta:
        model = Risk
        fields = ['id', 'label', 'activated', 'audio_url', 'pictogramme_url', 'created_at', 'created_by']

    def get_audio_url(self, risk):
        request = self.context.get('request')
        # 先判断request是否存在，再判断文件字段是否有值
        if not request or not risk.audio:
            return None
        return request.build_absolute_uri(risk.audio.url)

    def get_pictogramme_url(self, risk):
        request = self.context.get('request')
        if not request or not risk.pictogramme:
            return None
        return request.build_absolute_uri(risk.pictogramme.url)

3. 简化视图集代码（可选但推荐） #

DRF的ModelViewSet默认会自动把request传入序列化器的context，所以你写的get_serializer_context是多余的，删除后可以避免不必要的上下文覆盖问题：

class RiskViewSet(viewsets.ModelViewSet):
    queryset = Risk.objects.all()
    serializer_class = RiskSerializer

4. 验证绝对URL生成逻辑 #

如果上述修改后字段正常显示，但URL还是不符合预期，检查以下两点：

• 确保请求的Host头是你的站点域名（Postman中默认会自动携带，也可以手动设置）。
• 如果需要固定域名生成URL，可以直接替换request.build_absolute_uri为硬编码域名拼接，比如：

  return f"https://your-domain.com{risk.audio.url}"
  

额外排查项 #

如果问题仍未解决，打开Django的DEBUG模式，查看控制台日志：

• 是否有字段不存在的错误（比如模型中没有audio或pictogramme字段）。
• 是否有权限类拦截了字段的访问。
• 清除Postman的缓存，重新发送请求，确保获取的是最新响应。

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