Django DRF ViewSet URL反转问题：'orderitem-list'遇NoReverseMatch错误

问题根源 #

你在使用DefaultRouter注册OrderItemViewSet时，前缀里手动添加了正则开头的^符号，但DefaultRouter的prefix参数不需要额外加^——Django路由系统会自动为路由规则添加首尾匹配约束，手动加^会导致生成的URL规则包含该符号，进而在反转时无法匹配到有效路由。

修复方案 #

1. 修正基础路由注册 #

直接去掉OrderItemViewSet前缀中的^符号，修改后的路由代码如下：

router = DefaultRouter()
router.register(r"", OrderViewSet, basename="order")
# 移除前缀里的^
router.register(r"(?P<order_id>\d+)/order-items", OrderItemViewSet, basename="orderitem")
    
urlpatterns = [path("", include(router.urls)),]

2. 更规范的嵌套路由方案（可选） #

由于OrderItem是Order的子资源，使用嵌套路由更符合RESTful规范，需要先安装drf-nested-routers库，再配置路由：

from rest_framework_nested import routers

# 根路由注册Order
router = routers.DefaultRouter()
router.register(r"", OrderViewSet, basename="order")

# 基于Order路由生成嵌套的OrderItem路由
order_router = routers.NestedDefaultRouter(router, r"", lookup="order")
order_router.register(r"order-items", OrderItemViewSet, basename="order-orderitem")

urlpatterns = [
    path("", include(router.urls)),
    path("", include(order_router.urls))
]

此时URL反转需使用order-orderitem-list作为名称，示例：reverse('order-orderitem-list', kwargs={'order_id': 1})。

验证反转有效性 #

修改后可以用以下代码测试URL反转是否正常：

from django.urls import reverse

# 测试基础方案的反转
reverse_url = reverse('orderitem-list', kwargs={'order_id': 1})
print(reverse_url)  # 预期输出类似 /1/order-items/

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