第一步：创建自定义404页面

您需要设计并创建一个HTML页面作为您的404错误页面，这个页面可以包含您网站的Logo、导航栏、一段友好的提示文字、一个返回首页的链接，甚至可以是一个搜索框,帮助用户快速找到他们想要的内容。

一个简单的页面示例如下：

页面未找到
404
抱歉，您访问的页面似乎丢失在了数字宇宙中。
您可以尝试 返回首页 或使用搜索功能查找内容。

将此文件放置在您的Web应用的根目录下，例如 your-webapp/404.html 。

第二步：定位并编辑文件

文件有两个主要位置,选择哪个位置取决于配置的作用域：

强烈推荐 使用应用特定的文件进行配置，这样做可以确保配置与您的应用一同打包和部署，具有更好的可移植性和隔离性,不会影响服务器上的其他应用。

打开 your-webapp/WEB-INF/web.xml 文件，在标签内添加以下配置：

...404/404.html...

配置解析：

完成配置后，保存文件并重新启动您的Tomcat服务器或重新部署Web应用，当访问一个不存在的URL时（ ），您应该就能看到自定义的页面了。

高级配置方法

除了标准的XML配置，根据您的技术栈,还有其他更灵活的方式。

通过Servlet编程方式

对于需要动态生成错误内容的场景,可以创建一个专门的Servlet来处理404错误。

import javax.servlet.*;import javax.servlet.http.*;import javax.servlet.annotation.*;import java.io.IOException;@WebServlet("/error-handler")public class ErrorServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {// 可以在这里获取请求的URI等信息，动态生成页面内容String requestUri = (String) request.getAttribute("javax.servlet.error.request_uri");response.setContentType("text/html;charset=UTF-8");response.getWriter().println("
404 - 页面未找到
");response.getWriter().println("
您访问的页面 " + requestUri + " 不存在。
");response.getWriter().println("返回首页");}}

将指向这个Servlet的URL模式。

404/error-handler

在spring Boot项目中配置

如果您使用的是Spring Boot框架，事情会变得异常简单，Spring Boot的自动配置机制已经为您处理了大部分工作。

您只需在 src/main/resources/static 或 src/main/resources/templates 目录下创建一个名为 error.html 的文件即可。

Spring Boot会自动识别这个文件，并在发生4xx或5xx错误时将其作为默认错误页面呈现，您还可以通过创建一个实现了 ErrorController 接口的控制器类来实现更复杂的错误处理逻辑。

最佳实践与注意事项

相关问答FAQs

问题1：我已经按照教程修改了文件，但访问不存在的页面时显示的仍然是Tomcat默认的404页面，这是为什么？

解答： 这个问题通常由以下几个原因导致：

问题2：除了404错误，我还能用同样的方法配置其他HTTP错误码的页面吗？比如服务器内部错误500？

解答： 当然可以。标签的设计就是为了处理各种HTTP错误和Java异常，要配置500错误页面的方法与配置404完全相同，只需将的值改为,并指定一个对应的错误页面即可。

配置500错误页面：

500/500.html

您可以为任何您希望自定义处理的HTTP状态码（如403 Forbidden, 401 Unauthorized等）都添加类似的配置块。还可以通过子标签来捕获特定的Java异常,实现更精细的错误处理。