异常教程

Servlet HTTP 状态码（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Web 开发中，Servlet 是 Java 后端处理 HTTP 请求的核心组件，而 HTTP 状态码则是客户端与服务器通信时的“语言信号”。它们共同构成了 Web 应用的底层逻辑，帮助开发者快速定位问题、优化代码逻辑，并提升用户体验。对于编程初学者和中级开发者来说，掌握 Servlet HTTP 状态码 的含义、分类及实际应用，是构建健壮 Web 应用的必经之路。

HTTP 协议基础：状态码的诞生背景

HTTP（HyperText Transfer Protocol）是客户端（如浏览器）与服务器之间的通信协议。每当用户发起请求（如访问网页或提交表单），服务器会通过 HTTP 响应返回数据，而 状态码 正是响应中第一个关键信息。它由三位数字组成，分为五大类（1xx、2xx、3xx、4xx、5xx），每类代表不同的通信状态。

形象比喻：
可以将状态码想象为快递公司的包裹状态通知：

  • 200（成功送达）：包裹已安全到达收件人手中。
  • 404（未找到地址）：快递员找不到收件地址，无法派送。
  • 500（内部问题）：快递公司仓库发生故障，导致包裹无法处理。

状态码分类详解：从 100 到 5xx 的含义

1xx：信息性状态码（临时响应）

这类状态码表示服务器已接收请求，但需要客户端进一步操作才能完成。例如：

  • 100 Continue：服务器已收到请求头，允许客户端继续发送请求体。
  • 101 Switching Protocols：服务器同意切换协议（如从 HTTP 切换到 WebSocket）。

2xx：成功状态码

请求已成功被服务器处理：

  • 200 OK：最常见的成功响应，表示请求已正常完成。
  • 201 Created：资源创建成功（如用户注册后生成新账号）。
  • 204 No Content：请求成功，但无响应体（如删除操作后无需返回数据）。

3xx：重定向状态码

要求客户端重新发送请求到其他地址：

  • 301 Moved Permanently：资源永久迁移（如网站域名变更）。
  • 302 Found：临时重定向（如登录后跳转到主页）。
  • 304 Not Modified：资源未修改，使用缓存（优化性能的关键状态码）。

4xx：客户端错误状态码

请求因客户端问题无法完成：

  • 400 Bad Request：请求格式错误（如缺少必要参数）。
  • 401 Unauthorized：未授权访问（如未登录用户尝试访问私密页面）。
  • 403 Forbidden：服务器拒绝请求（如权限不足）。
  • 404 Not Found：资源不存在（如访问错误的 URL）。

5xx：服务器错误状态码

服务器自身出现问题导致请求失败：

  • 500 Internal Server Error：通用服务器错误（如代码逻辑异常）。
  • 502 Bad Gateway：服务器作为网关或代理时接收到了无效响应。
  • 503 Service Unavailable：服务器暂时过载或维护中。

在 Servlet 中如何使用 HTTP 状态码？

Servlet 是 Java Web 开发的核心组件，通过 HttpServletResponse 对象可直接设置 HTTP 状态码。以下是关键方法：

方法 1：setStatus(int sc)

直接设置状态码：

protected void doGet(HttpServletRequest request, HttpServletResponse response)  
        throws ServletException, IOException {  
    // 设置 404 状态码  
    response.setStatus(HttpServletResponse.SC_NOT_FOUND);  
    response.getWriter().write("资源未找到！");  
}

方法 2：sendError(int sc, String msg)

设置状态码并返回错误信息（常用于异常处理）：

protected void doPost(HttpServletRequest request, HttpServletResponse response)  
        throws ServletException, IOException {  
    try {  
        // 业务逻辑处理  
    } catch (IllegalArgumentException e) {  
        response.sendError(HttpServletResponse.SC_BAD_REQUEST, "参数格式错误");  
    }  
}

方法 3：结合 Filter 统一处理异常

通过过滤器（Filter）捕获全局异常并返回对应状态码：

public class GlobalExceptionFilter implements Filter {  
    @Override  
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)  
            throws IOException, ServletException {  
        try {  
            chain.doFilter(req, res);  
        } catch (Exception e) {  
            HttpServletResponse response = (HttpServletResponse) res;  
            response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);  
            response.getWriter().write("服务器内部错误，请稍后再试");  
        }  
    }  
}

实战案例：状态码的实际应用场景

案例 1：资源创建与状态码 201

当用户提交表单创建新资源（如博客文章）时，Servlet 应返回 201 Created：

protected void doPost(HttpServletRequest request, HttpServletResponse response)  
        throws ServletException, IOException {  
    String title = request.getParameter("title");  
    String content = request.getParameter("content");  
    if (title == null || content == null) {  
        response.sendError(HttpServletResponse.SC_BAD_REQUEST, "标题和内容不能为空");  
        return;  
    }  
    // 模拟保存到数据库  
    long newId = saveBlog(title, content);  
    response.setStatus(HttpServletResponse.SC_CREATED);  
    response.getWriter().write("文章创建成功，ID: " + newId);  
}

案例 2：处理 404 错误的优雅方式

通过自定义 404 页面提升用户体验：

protected void doGet(HttpServletRequest request, HttpServletResponse response)  
        throws ServletException, IOException {  
    String path = request.getRequestURI();  
    if (!isValidPath(path)) {  
        response.setStatus(HttpServletResponse.SC_NOT_FOUND);  
        RequestDispatcher dispatcher = request.getRequestDispatcher("/404.html");  
        dispatcher.forward(request, response);  
    } else {  
        // 正常处理逻辑  
    }  
}

状态码的最佳实践与常见误区

1. 避免滥用 200 状态码

即使请求成功，也应根据业务场景选择更精确的状态码。例如，资源更新应使用 200 OK，而资源创建应使用 201 Created。

2. 404 与 403 的区别

  • 404：资源不存在（如 URL 错误）。
  • 403：资源存在但禁止访问（如用户无权限查看）。

3. 全局异常处理的必要性

通过统一捕获异常并返回 500 Internal Server Error，避免暴露敏感信息（如堆栈跟踪）。

4. 客户端与服务器的协作

状态码不仅是服务器的“反馈”，也是客户端调整行为的依据。例如：

  • 客户端收到 304 Not Modified 时，应直接使用缓存。
  • 客户端收到 429 Too Many Requests 时，需降低请求频率。

结论：状态码是 Web 开发的“健康监测仪”

HTTP 状态码是连接客户端与服务器的“语言桥梁”，而 Servlet HTTP 状态码 的合理使用，则是提升 Web 应用健壮性与用户体验的核心能力之一。无论是处理表单提交、资源创建，还是调试错误，开发者都应以状态码为指南，设计出更可靠、更友好的系统。

通过本文的讲解，希望读者能够：

  1. 理解状态码的分类与含义；
  2. 掌握在 Servlet 中设置状态码的技巧；
  3. 避免常见误区，写出更规范的代码。

记住：一个精心设计的状态码响应，不仅能减少用户困惑，更能帮助开发者快速定位问题，让 Web 开发事半功倍！

最新发布

查看更多文章