ViewSet 的 list/retrieve/update 等动作需通过 DefaultRouter 或 SimpleRouter 自动绑定 URL，不配 Router 则仅为普通方法；必须设置 queryset 和 serializer_class（或重写 get_serializer_class）否则报错。
ViewSet 里 list/retrieve/update 这些动作怎么自动绑定到 URL？
DRF 的 ViewSet 本身不直接响应请求，必须配合 Router 才能生成标准 REST 路由。不配 router，list 和 retrieve 就只是普通方法，不会被 URL 访问到。
- 用
DefaultRouter（推荐）或SimpleRouter，别手写path()去映射每个动作 -
DefaultRouter会额外提供根路径（/api/）的 API 文档索引页，SimpleRouter不带这个，更轻量 - 注册时必须传视图集类名，不是实例：
router.register(r'users', UserViewSet)，不是UserViewSet() - 如果视图集没定义
queryset，retrieve/update等依赖对象查找的动作会报AssertionError: 'UserViewSet' should either include a `queryset` attribute
为什么 get_serializer_class() 比 serializer_class 更灵活？
一个 ViewSet 经常要对不同动作返回不同字段（比如 list 只返回 id/name，retrieve 返回全部），硬写死 serializer_class 会导致序列化逻辑耦合、字段冗余甚至 400 错误。
-
get_serializer_class()是钩子方法，在每次请求时动态返回序列化器类，适合按动作区分 - 常见写法是用
self.action判断当前动作名：if self.action == 'list': return UserListSerializer - 注意：不要在
get_serializer_class()里返回实例（如UserSerializer()），必须返回类（UserSerializer） - 如果用了
GenericAPIView的 mixin（比如RetrieveModelMixin），但没设serializer_class且没重写get_serializer_class，会直接报AttributeError: 'UserViewSet' object has no attribute 'serializer_class'
自定义动作（@action）加了 detail=True 却 404？
加了 @action(detail=True) 的方法，默认 URL 是 /api/users/{id}/xxx/，但如果你访问的是 /api/users/xxx/（少了个 ID），就会 404 —— 不是路由没注册，是路径根本匹配不上。
-
detail=True表示该动作作用于单个对象，URL 必须含主键参数；detail=False才走集合级路径 - 确保前端调用时路径拼对了，特别是 ID 是否传入、是否被 URL 编码（比如 UUID 中的短横线）
- 自定义动作默认只允许 GET，如需 POST，得显式写
@action(detail=True, methods=['post']) - 如果用了
url_path自定义路径名（比如@action(url_path='profile')），生成的 URL 是/api/users/{id}/profile/，别漏掉末尾斜杠（Django 默认要求 trailing slash）
Router 注册后 URL 冲突或 405 Method Not Allowed 怎么查？
冲突往往不是代码写错，而是多个视图集注册了相同 prefix，或者自定义 action 和内置动作同名（比如自己写了个叫 create 的 @action）。
立即学习“Python免费学习笔记（深入）”；
- 运行
python manage.py show_urls（需装django-extensions）看实际注册的路由表，确认路径和 HTTP 方法是否符合预期 -
405常见于：该动作没在methods列表里声明，或视图集继承了ReadOnlyModelViewSet却试图调update - 同一个
ViewSet里不要同时定义update()方法和@action(methods=['put'], detail=True)，否则 PUT /{id}/ 会歧义，DRF 优先走内置动作 - 如果用了
basename参数（如router.register(r'users', UserViewSet, basename='user')），确保它唯一且不含特殊字符，否则反向解析 URL 会失败
最常被忽略的是 queryset 和 serializer_class 的存在性检查 —— 它们不是可选配置，而是 DRF 在初始化阶段就强制校验的属性，出错提示往往藏在中间件或 mixin 的底层，而不是你的视图代码里。
