如何为drf-nested-routers嵌套资源配置超链接实现HATEOAS

报错由两处配置错误共同导致：

1. 路由basename不匹配：第三级details资源注册路由时，你写的basename是abc，但序列化器里引用的view_name是wizard-api:details-list，DRF无法找到对应的路由映射。
2. 超链接字段缺少必要路径参数：三级嵌套的wizard-api:details-list路由需要industry_pk、sub_industry_pk两个路径参数才能完成URL反解，你使用的HyperlinkedIdentityField默认只支持单参数映射，仅配置industry_pk时缺少必填的sub_industry_pk参数，无法拼出完整路径。

第一级行业资源的超链接能正常生效，是因为二级sub-industries-list路由仅需industry_pk一个参数，刚好匹配HyperlinkedIdentityField的单参数反解逻辑，到三级嵌套场景就不适用了。

1. 修正路由basename配置 #

统一第三级路由的basename命名，和前两级规则保持一致：

# Nested Routes
first_level = routers.SimpleRouter()
first_level.register(r'industries', views.IndustryViewSet, basename='industries')

second_level = routers.NestedSimpleRouter(first_level, r'industries', lookup='industry')
second_level.register(r'sub-industries', views.SubIndustryViewSet, basename='sub-industries')

# 将原basename='abc'改为basename='details'
third_level = routers.NestedSimpleRouter(second_level, r'sub-industries', lookup='sub_industry')
third_level.register(r'details', views.SubIndustryDetailsViewSet, basename='details')

2. 自定义超链接字段的反解逻辑 #

替换原有的HyperlinkedIdentityField，使用SerializerMethodField自定义URL反解逻辑，传入所有必填的路径参数：

from rest_framework.reverse import reverse

class SubIndustryModelSerializer(serializers.ModelSerializer):
    details = serializers.SerializerMethodField()

    def get_details(self, obj):
        request = self.context.get('request')
        # 从视图上下文获取上层路由传入的industry_pk
        industry_pk = self.context.get('view').kwargs.get('industry_pk')
        # 传入两个必填参数反解三级列表路由
        return reverse(
            'wizard-api:details-list',
            kwargs={
                'industry_pk': industry_pk,
                'sub_industry_pk': obj.pk
            },
            request=request
        )

    class Meta:
        model = SubIndustry
        exclude = ['created', 'modified', 'active']

配置完成后访问/wizard-api/industries/1/sub-industries/接口，即可返回预期结果：

[
    {
        "id": 1,
        "name": "beverage industries",
        "details": "http://127.0.0.1:8000/wizard-api/industries/1/sub-industries/1/details/"
    },
    {
        "id": 2,
        "name": "food production",
        "details": "http://127.0.0.1:8000/wizard-api/industries/1/sub-industries/2/details/"
    }
]

后续如果需要在details层级返回关联资源链接、或者配置更深层级的嵌套路由超链接，都可以沿用这个方案：从视图的kwargs中提取所有上层路径参数，结合当前序列化对象的主键，通过reverse方法反解完整URL即可。原生HyperlinkedIdentityField仅支持单路径参数的URL反解，多级嵌套场景下自定义SerializerMethodField是兼容性最好的实现方式。

内容的提问来源于stack exchange，提问作者Santiago Ortiz Ceballos