SpringMVC多种响应返回方式详解

这几天后台收到不少关于 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"：代表重定向，不再走视图解析器

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，直接返回实体对象）

四、一张表梳理所有场景

五、选型建议

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

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