Spring MVC 响应处理：页面、数据与状态码配置详解 | 极客日志

Java大前端java

Spring MVC 响应处理：页面、数据与状态码配置详解

Spring MVC 响应机制涵盖视图解析、数据序列化及 HTTP 状态管理。文章深入剖析@Controller 与@RestController 的差异，演示如何通过注解控制返回类型。结合静态页面渲染、JSON 数据输出及 Header 设置实例，讲解常见陷阱。最后通过计算器与登录功能实战，展示 Session 管理与 AJAX 交互流程，帮助开发者掌握前后端通信核心要点。

zhang发布于 2026/3/15更新于 2026/4/263 浏览

Spring MVC 响应处理：页面、数据与状态码配置详解

响应概述

响应（Response）是服务器针对客户端请求返回的反馈信息。在 Spring MVC 中，我们主要关注如何控制这些响应的形式，无论是页面跳转、数据返回还是状态码设置。

返回静态页面

当我们希望返回一个 HTML 页面时，通常使用 @Controller 注解配合视图解析器。

示例代码：

@Controller
@RequestMapping("response")
public class ResponseController {
    @RequestMapping("/1")
    public String method1() {
        return "/index.html";
    }
}

如果你使用了 @RestController，可能会发现页面没有正常跳转，而是直接显示了路径字符串。这是因为 @RestController 是 @Controller 加上 @ResponseBody 的组合，它默认不经过视图解析，直接将返回值作为响应体发送。

修正方案：

确保类上标注 @Controller，这样返回的字符串会被视为视图名称进行解析。

@Controller
@RequestMapping("response")
public class ResponseController {
    @RequestMapping("/1")
    public String method1() {
        return "/index.html";
    }
}

结果展示

返回数据：@ResponseBody

如果不需要跳转页面，而是直接返回文本或数据给前端，可以使用 @ResponseBody。它会将方法的返回值直接写入 HTTP 响应体，绕过视图解析。

@RequestMapping("/2")
@ResponseBody
public String method2() {
     ;
}

对比项	@RestController	@ResponseBody
作用范围	只能用在类上	只能用在方法上
功能本质	相当于 `@ResponseBody` + `@Controller`	单独注解，仅控制方法返回
使用场景	整个类都返回数据，一次注解全类生效	类用 `@Controller` 时，个别方法需返回数据
视图解析	不走视图解析，直接返回数据	不走视图解析，直接返回数据

@RequestMapping(value = "/5", produces = "text/plain")
@ResponseBody
public String method5() {
    return "<h1>我是一级标题<h1>";
}

public class UserInfo {
    private String name;
    private int age;
    // 构造器、Getter、Setter 省略
    @Override
    public String toString() {
        return "UserInfo{" + "name='" + name + '\'' + ", age=" + age + '}';
    }
}

@RequestMapping("/6")
@ResponseBody
public UserInfo method6() {
    UserInfo userInfo = new UserInfo("lisi", 13);
    return userInfo;
}

@RequestMapping("/7")
@ResponseBody
public String method7(HttpServletResponse response) {
    response.setStatus(401);
    return "设置状态码成功";
}

@RequestMapping("/8")
@ResponseBody
public String method8(HttpServletResponse response) {
    response.setHeader("headerkey", "headervalue");
    return "设置 header 成功";
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
    <form action="calc/sum" method="post">
        <h1>计算器</h1>
        数字 1：<input name="num1" type="text"><br>
        数字 2：<input name="num2" type="text"><br>
        <input type="submit" value="点击相加">
    </form>
</body>
</html>

@RestController
@RequestMapping("/calc")
public class CalcController {
    @RequestMapping("/sum")
    public String method8(Integer num1, Integer num2) {
        if (num1 == null || num2 == null) {
            return "参数不合法";
        }
        Integer sum = num1 + num2;
        return "<h1>计算结果：" + sum + "</h1>";
    }
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>登录页面</title>
</head>
<body>
    <h1>用户登录</h1>
    用户名：<input name="userName" type="text"><br>
    密码：<input name="password" type="password"><br>
    <input type="button" value="登录" onclick="login()">
    <script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.7.1.min.js"></script>
    <script>
        function login() {
            $.ajax({
                type: "post",
                url: "/user/login",
                data: {
                    userName: $("#userName").val(),
                    password: $("#password").val()
                },
                success: function(result) {
                    if (result) {
                        location.href = "index2.html";
                    } else {
                        alert("密码错误");
                    }
                }
            });
        }
    </script>
</body>
</html>

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpSession;
import org.apache.commons.lang3.StringUtils;

@RequestMapping("/user")
@RestController
public class UserController {
    @RequestMapping("/login")
    public Boolean login(String userName, String password, HttpSession session) {
        if (!StringUtils.hasLength(userName) || !StringUtils.hasLength(password)) {
            return false;
        }
        if ("admin".equals(userName) && "123456".equals(password)) {
            session.setAttribute("userName", userName);
            return true;
        }
        return false;
    }

    @RequestMapping("/getLoginUser")
    public String getLoginUser(HttpSession session) {
        String userName = (String) session.getAttribute("userName");
        return userName;
    }
}

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>用户登录首页</title>
</head>
<body>
    登录人：<span id="loginUser"></span>
    <script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.7.1.min.js"></script>
    <script>
        $.ajax({
            url: "/user/getLoginUser",
            type: "get",
            success: function(userName) {
                $("#loginUser").text(userName);
            }
        });
    </script>
</body>
</html>