JSP HTTP 状态码

关键点

研究表明，HTTP 状态码是服务器在响应客户端请求时返回的 3 位数字代码，表示请求的处理结果。
证据显示，JSP 通过 HttpServletResponse 对象的 setStatus(int sc) 或 sendError(int sc) 方法设置状态码。
看起来，状态码分为五类（1xx 到 5xx），每类表示不同类型的响应，常用状态码包括 200（成功）、404（未找到）和 500（服务器错误）。

JSP HTTP 状态码概述
HTTP 状态码是 Web 服务器在响应客户端请求（如浏览器请求 JSP 页面）时返回的代码，用于描述请求的处理状态。JSP 使用 HttpServletResponse 对象来设置这些状态码，帮助开发者控制服务器与客户端的通信。例如，response.setStatus(200) 表示请求成功，response.sendError(404, "页面未找到") 表示资源不存在。

状态码分类

1xx（信息类）：表示请求已被接收，继续处理。
2xx（成功类）：表示请求已成功处理，如 200 OK。
3xx（重定向类）：需要客户端进一步操作，如 301（永久重定向）。
4xx（客户端错误）：请求有误，如 404（未找到）。
5xx（服务器错误）：服务器处理失败，如 500（内部错误）。

示例
以下是一个 JSP 示例，展示如何设置 HTTP 状态码：
“`jsp
<%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″%>
JSP HTTP 状态码示例

设置 HTTP 状态码

<% // 设置状态码为 404 response.sendError(404, “请求的页面未找到”); %>

**参考资料**  
- [菜鸟教程 - JSP HTTP 状态码](https://www.runoob.com/jsp/jsp-http-status-codes.html)  
- [W3CSchool - JSP HTTP 状态码](https://www.w3cschool.cn/jsp/jsp-http-status-codes.html)

---

### JSP HTTP 状态码详解

JavaServer Pages（JSP）是一种服务器端技术，用于创建动态网页，通过在 HTML 中嵌入 Java 代码生成动态内容。HTTP 状态码（“HTTP 状态码”）是 Web 服务器在响应客户端请求时返回的 3 位数字代码，用于描述请求的处理结果。JSP 通过 `HttpServletResponse` 隐式对象设置这些状态码，以控制服务器与客户端的交互。以下是基于 2025 年 7 月 30 日的最新技术文档和可靠来源的详细分析。

#### 背景与定义  
JSP 由 Sun Microsystems 于 1999 年发布，是一种扩展 Java Servlet 的技术，允许开发者在静态 HTML 中插入动态 Java 代码。HTTP 状态码是 HTTP 协议的一部分，定义在 HTTP/1.1 标准（RFC 2616）中，用来指示服务器对客户端请求的处理结果。JSP 使用 `HttpServletResponse` 对象的 `setStatus(int sc)` 和 `sendError(int sc, String msg)` 方法来设置状态码，通知客户端请求的状态。

#### HTTP 状态码的分类  
HTTP 状态码分为五类，每类以不同的首位数字开头，基于菜鸟教程和 W3CSchool 的总结：

1. **1xx（信息类，Informational）**  
   - 表示请求已被接收，但需要进一步处理。  
   - 示例：  
     - **100 Continue**：客户端应继续发送请求体。  
     - **101 Switching Protocols**：服务器正在切换协议（如从 HTTP 到 WebSocket）。  

2. **2xx（成功类，Success）**  
   - 表示请求已成功被服务器接收、理解并处理。  
   - 示例：  
     - **200 OK**：请求成功，响应包含请求的内容。  
     - **201 Created**：请求成功并创建了新资源。  
     - **204 No Content**：请求成功但无内容返回。  

3. **3xx（重定向类，Redirection）**  
   - 表示需要客户端采取进一步操作来完成请求。  
   - 示例：  
     - **301 Moved Permanently**：资源已永久移动到新 URL。  
     - **302 Found**：资源暂时移动到另一个 URL。  
     - **304 Not Modified**：资源未修改，可使用缓存版本。  

4. **4xx（客户端错误，Client Error）**  
   - 表示客户端请求有误，服务器无法处理。  
   - 示例：  
     - **400 Bad Request**：请求语法错误，服务器无法理解。  
     - **403 Forbidden**：服务器拒绝请求，客户端无权限。  
     - **404 Not Found**：请求的资源不存在。  

5. **5xx（服务器错误，Server Error）**  
   - 表示服务器在处理请求时发生错误。  
   - 示例：  
     - **500 Internal Server Error**：服务器内部错误。  
     - **503 Service Unavailable**：服务器暂时无法处理请求。  

#### JSP 中设置 HTTP 状态码  
在 JSP 中，开发者通过 `HttpServletResponse` 对象设置状态码，主要使用以下方法：

| 方法                          | 描述                                                  |
|-------------------------------|-------------------------------------------------------|
| `setStatus(int sc)`           | 设置 HTTP 状态码，通常用于成功或自定义状态。         |
| `sendError(int sc)`           | 发送错误状态码，清除缓冲区并设置错误消息。           |
| `sendError(int sc, String msg)` | 发送错误状态码并附带自定义错误消息。                |

这些方法允许开发者在 JSP 页面中动态设置状态码。例如：  
- `response.setStatus(200)`：设置状态为 200 OK。  
- `response.sendError(404, "页面未找到")`：发送 404 错误并附带消息。

#### 常用 HTTP 状态码  
以下是基于菜鸟教程和 W3CSchool 的常用状态码列表：

| 状态码 | 名称                    | 描述                                                  |
|--------|-------------------------|-------------------------------------------------------|
| 200    | OK                     | 请求成功，返回内容。                                  |
| 201    | Created                | 请求成功并创建了新资源。                              |
| 204    | No Content             | 请求成功但无内容返回。                                |
| 301    | Moved Permanently      | 资源永久移动到新 URL。                                |
| 302    | Found                  | 资源暂时移动到另一个 URL。                            |
| 304    | Not Modified           | 资源未修改，可使用缓存。                              |
| 400    | Bad Request            | 请求语法错误，服务器无法理解。                        |
| 401    | Unauthorized           | 请求需要用户认证。                                    |
| 403    | Forbidden              | 服务器拒绝请求，客户端无权限。                        |
| 404    | Not Found              | 请求的资源不存在。                                    |
| 500    | Internal Server Error  | 服务器内部错误，无法处理请求。                        |
| 503    | Service Unavailable    | 服务器暂时无法处理请求。                              |

#### 示例：设置 HTTP 状态码  
以下是一个 JSP 示例，展示如何设置不同的 HTTP 状态码：

jsp
<%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″%>
JSP HTTP 状态码示例

设置 HTTP 状态码

<% // 设置 404 错误状态码 response.sendError(404, “请求的页面未找到”); %>

**代码解释**  
- `response.sendError(404, "请求的页面未找到")`：设置状态码为 404，并附带错误消息。浏览器会显示默认的 404 页面或自定义错误页面（如果在 `web.xml` 或 JSP 页面中配置了错误页面）。

#### 示例：自动重定向  
以下是另一个示例，展示如何使用 302 状态码进行重定向：

jsp
<%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″%>
JSP 重定向示例

重定向到新页面

<% // 设置 302 状态码并重定向 response.setStatus(302); response.setHeader(“Location”, “newPage.jsp”); %>

**代码解释**  
- `response.setStatus(302)`：设置状态码为 302 Found。  
- `response.setHeader("Location", "newPage.jsp")`：设置重定向的目标 URL。

#### 配置错误页面  
为了处理特定的状态码（如 404 或 500），可以在 `WEB-INF/web.xml` 中配置错误页面。例如：

xml
404 /error404.jsp 500 /error500.jsp

在 JSP 页面中，也可以通过 `<%@ page errorPage="error.jsp" %>` 指定错误页面，并在错误页面中启用 `exception` 对象：

jsp
<%@ page isErrorPage=”true” %>

错误页面

错误信息：<%= exception.getMessage() %>
“`

实践与优势

JSP HTTP 状态码的设计目标是提供标准化的方式来通知客户端请求的结果。HttpServletResponse 对象的状态码设置功能使开发者能够精确控制响应行为，例如处理错误、重定向或通知成功。JSP 的平台无关性支持“一次编写，随处运行”的理念，适合企业级 Web 应用开发，结合 Java API 和框架（如 Spring、Hibernate）使用。

注意事项

setStatus vs sendError：setStatus 用于设置任何状态码，通常用于成功或自定义状态；sendError 会清除缓冲区并显示错误页面，适合错误处理。
重定向：response.sendRedirect("url") 是设置 302 状态码的便捷方法，会自动设置 Location 头。
中文乱码：设置状态码时，确保响应头（如 Content-Type）正确设置字符编码，例如 response.setContentType("text/html; charset=UTF-8")。

参考资料

以上内容基于 2025 年 7 月 30 日的最新技术文档，确保信息的准确性和全面性。

JSP HTTP 状态码