Tomcat(100) 如何在Tomcat中配置自定义错误页面？_tomcat自定义错误页面-优快云博客

本文链接：https://blog.youkuaiyun.com/qq_43012298/article/details/139174465

在Tomcat中配置自定义错误页面可以帮助你为不同类型的错误提供用户友好的反馈。这个过程主要涉及修改你的Web应用程序的web.xml文件，并创建相应的错误页面。以下是详细步骤和代码示例：

1. 修改`web.xml`文件

在你的Web应用程序的WEB-INF目录下找到或创建web.xml文件。

1.1 配置基于状态码的错误页面

你可以为不同的HTTP状态码配置自定义的错误页面。例如，404未找到和500内部服务器错误：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <!-- 状态码404的错误页面 -->
    <error-page>
        <error-code>404</error-code>
        <location>/error-pages/404.html</location>
    </error-page>

    <!-- 状态码500的错误页面 -->
    <error-page>
        <error-code>500</error-code>
        <location>/error-pages/500.html</location>
    </error-page>
</web-app>

1.2 配置基于异常类型的错误页面

你可以为特定的Java异常配置自定义的错误页面。例如，java.lang.NullPointerException和java.lang.ArithmeticException：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <!-- NullPointerException的错误页面 -->
    <error-page>
        <exception-type>java.lang.NullPointerException</exception-type>
        <location>/error-pages/npe.html</location>
    </error-page>

    <!-- ArithmeticException的错误页面 -->
    <error-page>
        <exception-type>java.lang.ArithmeticException</exception-type>
        <location>/error-pages/arithmetic.html</location>
    </error-page>
</web-app>

2. 创建错误页面

在你的Web应用程序目录下创建一个文件夹，例如error-pages，然后在这个文件夹中创建对应的HTML页面：

2.1 404.html

<!DOCTYPE html>
<html>
<head>
    <title>404 - 页面未找到</title>
</head>
<body>
    <h1>404 - 页面未找到</h1>
    <p>对不起，我们找不到您请求的页面。</p>
    <a href="/">返回首页</a>
</body>
</html>

2.2 500.html

<!DOCTYPE html>
<html>
<head>
    <title>500 - 服务器内部错误</title>
</head>
<body>
    <h1>500 - 服务器内部错误</h1>
    <p>抱歉，服务器遇到了一些问题。请稍后再试。</p>
    <a href="/">返回首页</a>
</body>
</html>

2.3 npe.html

<!DOCTYPE html>
<html>
<head>
    <title>Null Pointer Exception</title>
</head>
<body>
    <h1>Null Pointer Exception</h1>
    <p>抱歉，服务器遇到了一个空指针异常。</p>
    <a href="/">返回首页</a>
</body>
</html>

2.4 arithmetic.html

<!DOCTYPE html>
<html>
<head>
    <title>Arithmetic Exception</title>
</head>
<body>
    <h1>Arithmetic Exception</h1>
    <p>抱歉，服务器遇到了一个算术异常。</p>
    <a href="/">返回首页</a>
</body>
</html>

3. 部署并测试

将你配置好的Web应用程序部署到Tomcat中，并启动Tomcat服务器。可以通过访问不存在的URL来测试404页面，通过触发空指针异常或算术异常来测试对应的异常页面。

4. 进阶：动态错误页面

如果你希望错误页面更加动态，可以使用JSP或Servlet来生成错误页面。例如，创建一个名为error.jsp的页面：

error.jsp

<%@ page isErrorPage="true" %>
<!DOCTYPE html>
<html>
<head>
    <title>错误</title>
</head>
<body>
    <h1>发生错误</h1>
    <p>错误代码: ${pageContext.errorData.statusCode}</p>
    <p>错误消息: ${pageContext.errorData.message}</p>
    <p>异常类型: ${pageContext.errorData.exception}</p>
    <p>请求URI: ${pageContext.errorData.requestURI}</p>
    <a href="/">返回首页</a>
</body>
</html>

然后在web.xml中配置：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <!-- 状态码404的错误页面 -->
    <error-page>
        <error-code>404</error-code>
        <location>/error.jsp</location>
    </error-page>

    <!-- 状态码500的错误页面 -->
    <error-page>
        <error-code>500</error-code>
        <location>/error.jsp</location>
    </error-page>

    <!-- NullPointerException的错误页面 -->
    <error-page>
        <exception-type>java.lang.NullPointerException</exception-type>
        <location>/error.jsp</location>
    </error-page>

    <!-- ArithmeticException的错误页面 -->
    <error-page>
        <exception-type>java.lang.ArithmeticException</exception-type>
        <location>/error.jsp</location>
    </error-page>
</web-app>