DRF ModelViewSet注册路由后POST请求报方法不允许问题排查

基础路由映射规则 #

通过router.register(r"polls", QuestionViewSet, basename="polls")完成注册后，ModelViewSet会自动完成请求方法与内部方法的绑定：

• 集合端点/polls/的POST请求，会自动映射到视图集内置的create方法
• 单个资源端点/polls/{id}/的增删改查请求，会分别对应retrieve/update/partial_update/destroy方法

报错原因与修正方案 #

1. 序列化器配置语法错误 #

当前视图集代码存在典型配置错误：

# 错误写法
class QuestionViewSet(viewsets.ModelViewSet):
    queryset = Question.objects.all()
    serializer_class = QuestionSerializer()

serializer_class参数要求直接传入序列化器类本身，不能加括号完成实例化。DRF会在请求处理流程中，根据请求上下文动态实例化序列化器，手动实例化会导致视图集的方法分发逻辑异常，最终触发Method "POST" not allowed的报错。
修正为：

# 正确写法
class QuestionViewSet(viewsets.ModelViewSet):
    queryset = Question.objects.all()
    serializer_class = QuestionSerializer

2. 路由挂载有效性校验 #

检查项目根目录的urls.py配置，确认是否将当前app的路由正确挂载：
如果上述路由注册逻辑写在app内部的urls.py中，必须在项目根urls.py中通过include引入，例如：

# 项目根urls.py 参考配置
urlpatterns = [
    # 原有其他路由
    path('', include('你的app名称.urls')),
]

如果未正确挂载，/polls/路径会命中Django默认的405响应逻辑，而非你注册的视图集。

3. 后续可能触发的校验问题 #

修正上述核心错误后，当前测试请求中传入的pub_date: "01-01-2021"会触发序列化校验失败：DRF的DateTimeField默认仅接受ISO 8601格式的时间字符串，可将传入值调整为"2021-01-01T00:00:00Z"格式，或在序列化器中自定义pub_date的输入格式。

内容的提问来源于stack exchange，提问作者Kyle Calica-St