Spring Boot @ResponseStatus

来源：这里教程网时间：2026-02-17 21:33:25 作者：

Spring Boot @ResponseStatus 教程展示了如何在 Spring 应用中使用@ResponseStatus 注解。

Spring 是流行的 Java 应用框架，而 Spring Boot 是 Spring 的演进，可以帮助轻松地创建独立的，生产级的基于 Spring 的应用。

@ResponseStatus

@ResponseStatus用应返回的状态代码和原因消息标记方法或异常类。调用处理程序方法时或抛出指定的异常时，状态代码将应用于 HTTP 响应。它会覆盖通过其他方式设置的状态信息，例如ResponseEntity或redirect:。

Spring Boot @ResponseStatus示例

在以下应用中，我们演示@ResponseStatus注解的用法。该应用模拟用于通过其 ID 检索订单的表单。尝试查找 ID 大于 500 的订单将引发异常。由于此异常，将显示一个自定义错误页面。

pom.xmlsrc├── main│   ├── java│   │   └── com│   │       └── zetcode│   │           ├── Application.java│   │           ├── controller│   │           │   └── MyController.java│   │           └── exception│   │               └── OrderNotFoundException.java│   └── resources│       ├── static│       │   └── index.html│       └── templates│           └── error.ftl└── test    └── java

这是 Spring 应用的项目结构。

pom.xml

<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>com.zetcode</groupId>    <artifactId>springbootresponsestatusex</artifactId>    <version>1.0-SNAPSHOT</version>    <packaging>jar</packaging>    <properties>        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>        <maven.compiler.source>11</maven.compiler.source>        <maven.compiler.target>11</maven.compiler.target>    </properties>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>2.1.1.RELEASE</version>    </parent>    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-freemarker</artifactId>        </dependency>    </dependencies>    <build>        <plugins>            <plugin>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-maven-plugin</artifactId>            </plugin>        </plugins>    </build></project>

这是 Maven pom.xml文件。 spring-boot-starter-freemarker是 Freemarker 模板引擎的依赖项； spring-boot-maven-plugin将 Spring 应用打包到可执行的 JAR 或 WAR 归档文件中。

com/zetcode/controller/MyController.java

package com.zetcode.controller;import com.zetcode.exception.OrderNotFoundException;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.PathVariable;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.ResponseBody;@Controllerpublic class MyController {    @RequestMapping(value = "/orders/{id}")    @ResponseBody    public String getOrder(@PathVariable("id") long id) {        if (id < 0 || id > 500) {            var message = String.format("Order %d not found", id);            throw new OrderNotFoundException(message);        }        var message = String.format("Returning order %d", id);        return message;    }}

MyController's getOrder()方法响应客户端请求。它使用@PathVariable从路径读取顺序 ID。

if (id < 0 || id > 500) {    var message = String.format("Order %d not found", id);    throw new OrderNotFoundException(message);}

对于无效订单（id < 0）和大于 500 的订单，我们抛出OrderNotFoundException异常。这是订单系统的简单模拟。

var message = String.format("Returning order %d", id);

对于其他订单 ID，我们返回一条消息，指示已找到并返回了该订单。

com/zetcode/exception/OrderNotFoundException.java

package com.zetcode.exception;import org.springframework.http.HttpStatus;import org.springframework.web.bind.annotation.ResponseStatus;@ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "No such order")public class OrderNotFoundException extends RuntimeException {    public OrderNotFoundException(String message) {        super(message);    }}

我们有一个自定义OrderNotFoundException。它以@ResponseStatus注解装饰。该值设置为HttpStatus.NOT_FOUND，并且原因消息显示“无此顺序”。此信息将在错误页面中使用。

resources/static/index.html

<!DOCTYPE html><html>    <head>        <title>Home page</title>        <meta charset="UTF-8">        <meta name="viewport" content="width=device-width, initial-scale=1.0">    </head>    <body>        <a href="/orders/505/">Get order with Id 505</a>    </body></html>

这是主页。它包含一个链接，用于查找带有 ID 505 的订单。该文件位于src/main/resources/static目录中。

resources/templates/error.ftl

<html>    <head>        <title>Error page</title>        <meta charset="UTF-8">        <meta name="viewport" content="width=device-width, initial-scale=1.0">    </head>    <body>        <div>            <h1>Error occurred</h1>            <p> ${status}:$ {error} - ${message}</p>        </div>    </body></html>

error.ftl是通用错误页面。这是 Freemarker 模板文件，显示状态，错误和原因消息。这些值是通过@ResponseStatus设置的。它位于src/main/resources/templates目录中。

com/zetcode/Application.java

package com.zetcode;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublic class Application  {    public static void main(String[] args) {        SpringApplication.run(Application.class, args);    }}

Application是设置 Spring Boot 应用的入口。

Error page