当前位置:

首页 > 编程开发 > SpringMVC多种响应返回方式详解

SpringMVC多种响应返回方式详解

这几天后台收到不少关于 SpringMVC 返回方式的提问,问题集中在几个点上:Controller 方法到底能怎么返回数据?不同返回形式底层流程有什么区别?什么时候页面会404?@ResponseBody 加在哪里?@RestController 原理是什么? 今天这篇文章,就围绕传统服务端渲染(

本文目录

    这几天后台收到不少关于 SpringMVC 返回方式的提问,问题集中在几个点上:Controller 方法到底能怎么返回数据?不同返回形式底层流程有什么区别?什么时候页面会404?@ResponseBody 加在哪里?@RestController 原理是什么?

    今天这篇文章,就围绕传统服务端渲染(JSP/模板引擎)和前后端分离两种场景,系统梳理一下 SpringMVC 的各类返回形式。

    一、SpringMVC 各类返回形式完整梳理

    1. 返回普通字符串(视图名称,传统服务端渲染)

    @RequestMapping("/index")
    public String index(){
        // 返回视图名
        return "index";
    }

    ✅ 执行流程:

    1. SpringMVC 获取返回字符串 index
    2. 视图解析器 ViewResolver 拼接前缀、后缀,找到视图资源(如 /WEB-INF/index.jsp)
    3. 请求转发到该页面渲染,把 Model 中存放的数据带到页面

    默认规则:返回字符串 = 视图名称 特殊前缀:

    • return "forward:/page":代表请求转发,不再走视图解析器
    • return "redirect:/login":代表重定向,不再走视图解析器

    SpringMVC多种响应返回方式详解

    2. 返回 void(极易出现404,重点避坑)

    @RequestMapping("/demo")
    public void demo(HttpServletRequest request,HttpServletResponse response){
    }

    ⚠️ 如果方法直接返回void,SpringMVC会尝试寻找和当前访问路径同名的视图,找不到就报404。 想要void不报错,三种方案(和图片描述一致):

    (1)使用response手动输出响应(直接写文本、JSON)

    response.setContentType("application/json;charset=utf-8");
    response.getWriter().write("{"code":200}");

    缺点:原生ServletAPI,代码繁琐,项目中不推荐大规模使用。

    (2)方法内手动执行 请求转发 forward

    request.getRequestDispatcher("/success").forward(request,response); 

    (3)方法内手动执行 重定向 redirect

    response.sendRedirect("/login"); 

    重要提醒:forward/redirect一旦执行,不要再次返回视图名称,也不要重复输出响应,会抛出异常。

    3. 返回 ModelAndView

    ModelAndView = Model(数据) + View(视图名称)

    @RequestMapping("/list")
    public ModelAndView list(){
        ModelAndView mv = new ModelAndView();
        mv.addObject("name","张三"); // 存入request域,页面可以获取
        mv.setViewName("list"); // 设置视图名称
        return mv;
    }

    特点:把数据和视图封装在同一个对象,老式项目使用较多;现代开发更推荐 Model + String 返回形式。

    4. 返回 Model + String(分离写法,开发最常用)

    @RequestMapping("/list")
    public String list(Model model){
        model.addAttribute("name","张三");
        return "list"; // 视图名称
    }
    • Model:用来向request域存放页面需要的数据
    • 返回字符串:视图名称 优势:数据、视图分离,代码可读性高于 ModelAndView,是服务端渲染项目主流写法。

    5. 返回JSON数据(前后端分离核心,@ResponseBody登场)

    上面4种全部是服务端渲染,跳转页面; 前后端分离项目,我们不需要跳转页面,而是直接返回JSON字符串给前端。 想要实现这个效果,核心注解:@ResponseBody

    // 方式1:注解加在方法上
    @RequestMapping("/user")
    @ResponseBody
    public User getUser(){
        User user = new User();
        user.setName("李四");
        return user; // 框架自动转为JSON
    }

    @ResponseBody核心作用

    告诉SpringMVC:不要使用视图解析器、不要跳转页面!直接把返回对象转为JSON,写入响应体返回浏览器。 底层原理: 返回对象 → MappingJackson2HttpMessageConverter → Jackson序列化 → JSON字符串 → 输出到response响应体。

    二、重点注解深度解析 @ResponseBody / @RestController

    1. @ResponseBody 可以写在哪里?

    两种合法位置:

    1. 写在Controller方法上:只对当前这一个方法生效
    @Controller
    public class UserController{
        @ResponseBody
        @RequestMapping("/user")
        public User getUser(){
            return new User();
        }
    }
    1. 写在Controller类上:当前类所有方法全部生效
    @Controller
    @ResponseBody
    public class UserController{
        // 所有方法返回值都会序列化为JSON,不再解析视图
    }

    2. @RestController 是什么?

    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    @Controller
    @ResponseBody
    public @interface RestController {
    }

    ✅ 结论: @RestController = @Controller + @ResponseBody 写在类上,代表:当前Controller所有方法,默认直接返回JSON,不跳转视图。

    // 等价于 @Controller + @ResponseBody
    @RestController
    public class UserController{
        @RequestMapping("/user")
        public User getUser(){
            return new User();
        }
    }

    3. 高频面试区分:@Controller VS @RestController

    1. @Controller
      • 默认:方法返回字符串 = 视图名称,用于页面跳转
      • 如果想要返回JSON,必须在方法上加 @ResponseBody
    2. @RestController
      • 自带 @ResponseBody,所有方法直接返回JSON

    无法直接通过返回字符串跳转页面

    如果RestController里一定要跳转页面,只能手动forward/redirect

    4. 极易踩坑的误区

    误区1:@RestController 能不能写页面跳转?

    不能直接return视图名。 如果必须跳转:

    // RestController中跳转写法
    return "forward:/index";
    return "redirect:/login";

    误区2:同时使用 @ResponseBody 和 forward/redirect

    @ResponseBody
    public String test(){
        // 冲突!@ResponseBody会把"forward:/index"当成普通字符串直接返回给前端,不会执行转发
        return "forward:/index";
    }

    重点:添加了@ResponseBody的方法,返回forward/redirect前缀字符串失效!如果想要实现转发和重定向,需要手动response.sendRedirect,但是不支持(因为很矛盾)

    误区3:@ResponseBody可以解析JSP页面 不可能。@ResponseBody的语义就是「返回响应体数据,放弃视图解析」。

    三、所有返回方式分类总结

    类别A:服务端渲染(跳转页面,传统JSP/Thymeleaf)

    1. 返回视图名称 String(配合Model传数据)
    2. 返回 ModelAndView

    控制器注解:@Controller,不能加@ResponseBody

    类别B:手动操控原生响应(void返回)

    1. response输出内容
    2. 代码内手动forward / redirect

    适合特殊场景,项目不推荐大量使用

    类别C:前后端分离(返回JSON,不跳转页面)

    1. @Controller + 方法上 @ResponseBody
    2. @RestController(内置ResponseBody,直接返回实体对象)

    四、一张表梳理所有场景

    返回类型配套注解作用
    String(普通视图名)@Controller走视图解析器,跳转页面
    String(forward:/ redirect:/)@Controller转发/重定向
    ModelAndView@Controller封装数据+视图,跳转页面
    void@Controller需要手动response输出/转发/重定向,否则404
    实体类/集合@Controller + @ResponseBody自动序列化为JSON返回
    实体类/集合@RestController全部方法默认返回JSON

    五、选型建议

    1. 传统服务端渲染项目(页面模板) 使用 @Controller,返回视图名称,配合Model传递数据。
    2. 前后端分离项目(Vue/小程序) 统一使用 @RestController,方法直接返回实体、统一结果对象。
    3. 一个Controller既有页面跳转,又有JSON接口 使用 @Controller,页面方法正常返回视图,接口方法单独加上 @ResponseBody。

    以上就是SpringMVC多种响应返回方式详解的全部内容,希望对你有帮助。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    WorkBuddy免费版能用吗?免费功能有哪些限制
    WorkBuddy免费版能用吗?免费功能有哪些限制

    WorkBuddy 免费版能用:体验版限时免费,每月 500 积分,限免期间享全模型调度、无限代码补全、99 个自动任务额度、每项目 5 人协作,另有 3 个自动任务、5 个项目、5GB 资料库、10 个云服务应用的数量限制。本文含官网定价页截图、积分消耗规律和免费补积分方法。

    Qwen Code 0.27.4如何理解临时授权、风险确认与消息分段
    Qwen Code 0.27.4如何理解临时授权、风险确认与消息分段

    解释Qwen Code 0.27.4临时目录授权、Managed Web Terminal、风险确认及飞书企业微信有序分段回复的边界。

    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?
    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?

    Claude Code 2.1.325改变了两类自动执行的默认行为:沙箱内Bash默认走常规权限流程,定时任务及/loop执行带allowed-tools或hooks声明的Skill会先请求确认。官方提供了对应配置,但受管环境必须遵守最高优先级的管理来源。

    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务
    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务

    Decider v1.3面向细致判断,Flash v1.3面向高量路由与过滤;locate抽取原文片段及位置,需与分类、多模态和托管入口限制分开理解。

    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?
    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?

    5.23.0影响范围取决于旧导出对象、音频依赖与专家并行路径,新增模型也有实验和变体限制。

    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?
    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?

    Copilot停用旧模型不等于自动迁移;区分移除、组织模型启用、工作流切换与个人年订阅例外。

    GitHub Actions重跑失败作业会使用最新代码吗
    GitHub Actions重跑失败作业会使用最新代码吗

    解释已有运行重跑的提交和权限边界,给出确认、失败作业重跑及结果核对命令,区分漏触发事件。

    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界
    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界

    chat-demo v0.1.1可以作为静态聊天客户端在本地运行,但模型、搜索、文件和语音能力仍由DeepSeek API提供。源码运行环境为Node.js 22.12及以上、Git与pnpm。Demo版本号不等于应用API版本;这套应用API未单独标版本,默认聊天模型ID是deepseek-flash。

    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解
    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解

    理解GitHub Copilot CLI v1.0.111的高级请求百分比、用户提示活动图与实际路由模型窗口,区分显示口径和任务状态。

    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?
    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?

    按维护分支、利用权限与节点类型对应四项修复,区分正式补丁、Beta和临时缓解的适用边界。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。