0

0

Django DRF视图集怎么用_ViewSet与Router自动生成RESTful路由

P粉602998670

P粉602998670

发布时间:2026-03-12 16:22:02

|

955人浏览过

|

来源于php中文网

原创

ViewSet不能直接当视图用,因为它只是封装增删改查方法的类,未绑定HTTP方法和路由,需通过as_view()映射或Router自动处理。

django drf视图集怎么用_viewset与router自动生成restful路由

ViewSet 为什么不能直接当视图用?

因为 ViewSet 本身不是视图函数或类视图,它只是把增删改查逻辑打包成方法(比如 listretrieve),但没绑定 HTTP 方法和 URL 路由。直接注册到 urlpatterns 会报 TypeError: ViewSet is not a valid view

  • 必须通过 as_view() 把具体动作映射成视图,例如 MyViewSet.as_view({'get': 'list'})
  • 更常见的是交给 Router 自动处理——它内部就做了这层映射
  • 如果你手动写 as_view(),注意字典 key 是 HTTP 方法小写,value 是 ViewSet 内的方法名,拼错就 405

SimpleRouter 和 DefaultRouter 有啥区别?

DefaultRouterSimpleRouter 多一个根路径(/)的 API 目录页,列出所有已注册的端点;它还默认为每个视图集加一个 api-root 名称,方便反向解析。

Krea AI
Krea AI

多功能的一站式AI图像生成和编辑平台

下载
  • 开发调试时用 DefaultRouter 更方便,上线可换回 SimpleRouter 省一点开销
  • 两者都支持 basename 参数,用于生成 URL name 和反向解析,尤其当视图集没绑定 queryset 时必须显式传
  • 别依赖 queryset 自动推导 basename:如果 queryset = None 或用了 get_queryset() 动态返回,不设 basename 就会报 AssertionError: Router must be provided with a basename

怎么让同一个 ViewSet 响应不同 URL 路径?

Router.register()basenameprefix 配合,或者用多个 register() 调用指向同一个视图集。

  • router.register('users', UserViewSet)/users//users/{id}/
  • router.register('staff', UserViewSet, basename='staff')/staff//staff/{id}/,这时必须写 basename,否则名字冲突
  • 两个注册共用一个视图集时,记得检查权限和 get_queryset() 是否兼容不同路径语义(比如 /staff/ 可能要过滤 is_staff=True

URL 反向解析时 name 对不上怎么办?

DRF 的 Router 生成的 URL name 格式固定:[basename]-[action],比如 user-listuser-detail。如果手写 name=... 或改过 basename,反向解析就会失败。

  • reverse('user-detail', kwargs={'pk': 123}) 前,先确认 basename 是什么(看 register() 第三个参数,没传就默认是模型名小写)
  • 自定义 action(比如加了 @action(methods=['post'], detail=True))会生成 user-custom-action 这样的 name,注意连字符和大小写
  • 模板里用 {% url 'user-list' %} 时,确保加载了 url 模板标签,且路由已包含在主 urls.py 中(常漏掉 include()
路由自动化的便利性藏在细节里:少写几行 urlpatterns 很爽,但一旦 basenamequeryset、自定义 action 名称或 Router 类型混用,出问题时错误信息往往不直接指向根源。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

166

2026.02.04

PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

179

2025.11.26

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

495

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

450

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

3545

2024.03.12

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2907

2024.08.16

PHP 命令行脚本与自动化任务开发
PHP 命令行脚本与自动化任务开发

本专题系统讲解 PHP 在命令行环境(CLI)下的开发与应用,内容涵盖 PHP CLI 基础、参数解析、文件与目录操作、日志输出、异常处理,以及与 Linux 定时任务(Cron)的结合使用。通过实战示例,帮助开发者掌握使用 PHP 构建 自动化脚本、批处理工具与后台任务程序 的能力。

66

2025.12.13

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

38

2026.03.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 4.9万人学习

Django DRF 源码解析
Django DRF 源码解析

共21课时 | 1.5万人学习

Django参考手册
Django参考手册

共0课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号