PAYATHON 2026

Tomcat 9 生产环境访问 WEB-INF 页面返回 404,开发环境正常,如何排查?

数据阿明

结论

WEB-INF 下的 JSP 不能通过浏览器直接访问,但 Servlet 可以使用 RequestDispatcher.forward() 在服务器内部转发到这些页面。你给出的转发方式符合这一用法。

仅凭现有代码无法确定生产环境 404 的唯一原因。先确认出错请求的实际 URL 和请求是否进入 ControllerServlet,再检查生产环境中是否存在转发目标 JSP。即使服务器日志没有异常,也不能排除路径或映射问题,因为返回 HTTP 404 不一定会抛出 Java 异常。

先确认访问入口和转发目标

浏览器应访问 Servlet 的映射地址:

/<context-path>/authentication
/<context-path>/main

将 <context-path> 替换为实际的应用上下文路径。如果应用部署在根上下文,地址就是 /authentication 和 /main。

直接请求下面这样的地址,返回 404 是正常的保护行为:

/<context-path>/WEB-INF/view/main.jsp

原代码生成的转发路径如下:

请求或处理结果 转发目标
GET /authentication /WEB-INF/view/authentication.jsp
POST /authentication,认证失败 /WEB-INF/view/authentication.jsp
POST /authentication,认证成功 /WEB-INF/view/main.jsp
GET 或 POST /main /WEB-INF/view/main.jsp

确认部署包中存在 authentication.jsp 和 main.jsp。问题中只将页面标为“登录 JSP”,没有给出实际文件名。如果文件实际叫 login.jsp,当前代码不会自动转发到它,需要调整文件名或转发逻辑。

JSP 中的 <link rel="canonical" href="https://bahiatransport.com.br/login"> 是页面元数据,不会创建 /login 的 Servlet 映射。给出的 @WebServlet 只声明了 /authentication 和 /main;如果实际访问的是 /login,还需要检查项目是否另有对应配置。

按请求是否进入 Servlet 排查

1. 在入口和转发位置记录路径

可以在 doGet() 和 doPost() 开头临时加入:

getServletContext().log(
    "ControllerServlet: method=" + request.getMethod()
    + ", contextPath=" + request.getContextPath()
    + ", servletPath=" + request.getServletPath()
);

再将两个方法末尾原有的转发代码块临时替换为:

String url = "/WEB-INF/view" + userPath + ".jsp";
getServletContext().log("Forward target: " + url);

if (getServletContext().getResource(url) == null) {
    throw new ServletException("JSP resource not found: " + url);
}

request.getRequestDispatcher(url).forward(request, response);

这段检查适用于当前按 JSP 文件路径转发的代码,可以帮助判断目标资源是否存在,但不能证明 JSP 能够成功编译和执行。两个方法原本就声明了 throws ServletException, IOException,可以直接让异常向上传递,保留原始堆栈。

不要在诊断日志中记录密码或完整 session ID。

2. 没有入口日志时,检查 URL 和映射

确认日志输出位置正确后,如果请求没有进入 Servlet,依次检查:

  • 浏览器实际提交的 URL 是否包含正确的 context path,可在开发者工具的 Network 面板中确认。
  • 应用是否成功部署,访问的是否是预期的应用和 Tomcat 实例。
  • ControllerServlet.class 是否进入部署包。它通常位于 WEB-INF/classes/br/com/bahiatransport/bahiatransport/controller/,也可能打包在 WEB-INF/lib 下的 JAR 中。
  • 如果存在 web.xml,检查是否设置了 metadata-complete="true"。该设置会使容器忽略包括 @WebServlet 在内的部署注解,此时需要调整配置或在 web.xml 中声明对应的 Servlet 和映射。
  • 如果生产环境配置了反向代理或 Filter,检查请求是否在到达 Servlet 前被改写、拦截或返回了 404。

原表单的写法可以保留:

<form action="<c:url value="/authentication"/>" method="post">

c:url 会按当前应用上下文生成地址。仍需检查浏览器实际收到的 HTML 和发出的请求,确认生产环境路径与部署配置一致。

3. 已进入 Servlet 时,检查实际部署内容

查看最终发布的 WAR,也要检查开发目录。将下面的 app.war 替换为实际文件名:

jar tf app.war

核对是否包含:

WEB-INF/view/authentication.jsp
WEB-INF/view/main.jsp

如果 Tomcat 使用解压后的目录运行,还应核对正在运行的部署目录是否与该 WAR 一致。

也要逐字比较路径的大小写。如果开发环境文件系统不区分大小写,而生产环境文件系统区分大小写,view 与 View、main.jsp 与 Main.jsp 的差别就可能导致生产环境找不到资源。现有信息没有说明操作系统,需要核对这一点。

转发路径开头的 / 表示当前 Web 应用根目录,因此这里应继续使用:

request.getRequestDispatcher("/WEB-INF/view/main.jsp")
       .forward(request, response);

不要在该路径前拼接 request.getContextPath();context path 用于客户端 URL,不属于这个应用内转发路径。

检查 JSP 中的 include 和静态资源路径

原登录 JSP 使用了相对 include:

<%@include file="WEB-INF/jspf/header.jspf" %>

该路径相对于当前 JSP 所在目录解析。如果登录 JSP 位于 /WEB-INF/view/,这段代码会指向 /WEB-INF/view/WEB-INF/jspf/header.jspf。如果片段实际位于 /WEB-INF/jspf/,应改为:

<%@include file="/WEB-INF/jspf/header.jspf" %>
<%@include file="/WEB-INF/jspf/footer.jspf" %>

缺少 include 文件通常会导致 JSP 编译错误和 HTTP 500。应根据实际状态码和 JSP 异常日志判断,不能直接认定它是当前 404 的原因。

CSS、favicon 和页面链接由浏览器根据可见 URL 解析,服务器内部 forward 不会改变地址栏。如果这些文件位于应用根目录,可以使用:

<link href="<c:url value='/favicon.ico'/>" rel="shortcut icon"/>
<link href="<c:url value='/style-header.css'/>" rel="stylesheet" type="text/css" media="screen">
<link href="<c:url value='/style.css'/>" rel="stylesheet" type="text/css" media="screen">
<a href="<c:url value='/index.jsp'/>">Home</a>

在 Network 面板中区分主文档 404 和 CSS、图标等子请求 404,两者需要检查的位置不同。

日志为什么可能没有报错?

容器、代理或应用可以通过状态码返回 HTTP 404,无须抛出 ServletException 或 IOException,所以原代码中的 catch 不一定会执行。

排查时,可以对照访问日志中的请求路径和状态码、Servlet 入口日志、实际转发路径以及部署包内容,确认请求到达了哪个环节,再判断需要修正入口 URL、Servlet 映射,还是 JSP 的文件名和打包路径。

备注:内容仅供参考。