异常教程

JSP 异常处理（超详细）

更新时间:

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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 开发中，JSP 异常处理是确保应用稳定性和用户体验的关键环节。JSP（JavaServer Pages）作为动态网页开发的核心技术之一，常与 Java 后端逻辑深度结合，而代码中难免会出现意外错误（如空指针、数据库连接失败等）。若未妥善处理异常，可能导致页面崩溃或敏感信息泄露。

本文将从零开始讲解 JSP 异常处理的核心机制，结合实际案例，帮助开发者构建健壮的 Web 应用。无论你是编程新手还是有一定经验的开发者，都能通过本文掌握 JSP 中的异常捕获、自定义错误页面设计、日志记录等实用技巧。

异常处理的基础概念：从交通事故到代码逻辑

什么是异常？

异常（Exception）是程序执行过程中出现的非预期错误。例如：

  • 访问未初始化的对象（NullPointerException）
  • 除数为零（ArithmeticException）
  • 文件读取失败（FileNotFoundException）

可以将异常想象成交通意外：当车辆（程序）在行驶中遇到障碍物（异常事件），若无交警（异常处理机制）及时干预，可能导致连环事故（程序崩溃）。

Java 异常分类

Java 异常分为两种类型：
| 类型 | 特点 | 示例 |
|---------------|----------------------------------------------------------------------|-------------------------------|
| Checked 异常 | 编译器强制要求处理（如 throws 或 try-catch） | IOException、SQLException |
| Unchecked 异常 | 运行时自动触发，无需显式处理（但建议处理） | NullPointerException、ArrayIndexOutOfBoundsException |

比喻解释：

  • Checked 异常如同“交通法规强制检查”——必须提前规划路线（代码逻辑）。
  • Unchecked 异常如同“突发交通事故”——虽无法完全预测，但可以通过驾驶技巧（代码健壮性）减少风险。

JSP 内置异常处理机制

方式一：page 指令与 errorPage

JSP 提供了内置的异常转移功能，通过 page 指令指定错误页面：

<%@ page errorPage="error.jsp" %>

当当前页面发生未捕获的异常时，会跳转到 error.jsp。在 error.jsp 中，需声明 isErrorPage="true" 并使用隐式对象 exception：

<%@ page isErrorPage="true" %>  
<!DOCTYPE html>  
<html>  
<head>  
    <title>错误提示</title>  
</head>  
<body>  
    <h1>系统发生错误</h1>  
    <p>错误类型： <%= exception.getClass().getName() %></p>  
    <p>错误信息： <%= exception.getMessage() %></p>  
</body>  
</html>

优点：简单直接，适合快速开发。
缺点：无法集中处理多个页面的异常，且错误页面信息有限。

方式二：Servlet 集中处理异常（web.xml 配置）

通过配置 web.xml，可以统一管理全局异常：

<error-page>  
    <exception-type>java.lang.Exception</exception-type>  
    <location>/error.jsp</location>  
</error-page>

此配置将所有未处理的 Exception 类型异常导向 error.jsp。相比 JSP 内置方式，它更灵活且易于维护。

在 JSP 脚本中手动抛出异常

使用 throw 关键字

开发者可通过 throw 主动抛出异常，例如：

<%  
    String username = request.getParameter("username");  
    if (username == null || username.isEmpty()) {  
        throw new IllegalArgumentException("用户名不能为空");  
    }  
%>

自定义异常类

针对业务场景，可创建自定义异常类：

// 自定义异常类  
public class UserNotFoundException extends RuntimeException {  
    public UserNotFoundException(String message) {  
        super(message);  
    }  
}

在 JSP 中使用：

<%  
    User user = UserService.findUserById(userId);  
    if (user == null) {  
        throw new UserNotFoundException("用户不存在");  
    }  
%>

异常日志与调试技巧

记录日志：与“事故现场记录”类比

日志是排查问题的“黑匣子”。在 JSP 中，可通过 log 方法记录异常信息：

<%  
    try {  
        // 可能抛出异常的代码  
    } catch (Exception e) {  
        getServletConfig().getServletContext().log("异常信息:", e);  
        throw e; // 重新抛出异常，确保后续处理  
    }  
%>

推荐工具：使用日志框架（如 Log4j、Logback），提供更灵活的配置和分级记录。

调试技巧：分层排查

  1. 前端验证：在表单提交前用 JavaScript 初步校验（如非空检查）。
  2. 服务层捕获：在 Java 服务方法中使用 try-catch，避免异常扩散。
  3. 全局异常处理器：通过 Filter 或 Servlet 统一处理未捕获异常。

常见问题与解决方案

问题 1：资源未关闭导致异常

例如数据库连接未关闭时，可能导致 SQLException。解决方案：

<%  
    Connection conn = null;  
    try {  
        conn = DBUtil.getConnection();  
        // 数据库操作  
    } catch (SQLException e) {  
        // 处理异常  
    } finally {  
        if (conn != null) {  
            try {  
                conn.close();  
            } catch (SQLException ex) {  
                // 记录日志  
            }  
        }  
    }  
%>

问题 2：errorPage 无效

可能原因：

  • 未在 JSP 页面中声明 errorPage 指令。
  • 错误页面未设置 isErrorPage="true"。
  • 异常被提前捕获（如 try-catch 中未重新抛出）。

最佳实践与进阶技巧

分层处理异常

结合 MVC 模式，异常应分层处理：

  1. 视图层（JSP）：仅负责显示错误提示，避免复杂逻辑。
  2. 控制层（Servlet/Controller）：捕获异常并记录日志，重定向到错误页面。
  3. 服务层（Service）：处理业务逻辑异常，如数据校验失败。

结合 MVC 的完整案例

// 控制器 Servlet  
protected void doPost(HttpServletRequest request, HttpServletResponse response) {  
    try {  
        String username = request.getParameter("username");  
        UserService.register(username);  
        response.sendRedirect("success.jsp");  
    } catch (IllegalArgumentException e) {  
        request.setAttribute("error", e.getMessage());  
        request.getRequestDispatcher("error.jsp").forward(request, response);  
    }  
}

异步请求的异常处理

对于 AJAX 请求，可通过 JSON 返回错误信息：

<%  
    response.setContentType("application/json");  
    try {  
        // 业务逻辑  
    } catch (Exception e) {  
        out.println("{\"status\": \"error\", \"message\": \"" + e.getMessage() + "\"}");  
    }  
%>

结论

JSP 异常处理是构建健壮 Web 应用的基石。通过结合内置机制、自定义错误页面、日志记录以及分层设计，开发者可以显著提升代码的容错能力和用户体验。

本文通过代码示例和类比，系统性地讲解了从基础概念到实战技巧的全流程。建议读者通过以下步骤实践：

  1. 在 JSP 中尝试 errorPage 指令和 web.xml 配置。
  2. 编写自定义异常类并测试日志记录功能。
  3. 结合 MVC 模式重构现有代码，实现分层异常处理。

记住：优秀的异常处理不是“消灭错误”，而是让错误成为优化系统的“指南针”。

最新发布

查看更多文章