@WebServlet注解与web.xml欢迎页无法关联，访问空白求助

核心排查与修复步骤 #

1. 补全Servlet实现逻辑 #

你的Security.java必须是完整的HttpServlet子类，重写doGet/doPost方法才能处理请求。空白页面大概率是因为Servlet没有执行任何输出逻辑，示例代码如下：

@WebServlet({"/login", "/logout"})
public class Security extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 示例：直接输出内容或转发到登录页面
        response.setContentType("text/html;charset=UTF-8");
        response.getWriter().write("<h1>登录页面</h1>");
        // 若要转发到JSP，可替换为：
        // request.getRequestDispatcher("/WEB-INF/login.jsp").forward(request, response);
    }
}

2. 修正欢迎页匹配逻辑 #

Jakarta EE的欢迎页机制优先查找物理文件/文件夹，只有当对应路径的物理资源不存在时，才会匹配Servlet映射：

• 检查项目webapp根目录下，是否存在名为login的文件或文件夹，若有则删除或重命名。
• 若希望强制通过Servlet处理欢迎页，可在web.xml中显式配置Servlet映射（注意：注解和xml配置二选一，避免冲突）：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xmlns="https://jakarta.ee/xml/ns/jakartaee" 
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd" 
         version="5.0">
  <display-name>balance</display-name>
  <welcome-file-list>
      <welcome-file>login</welcome-file>
  </welcome-file-list>
  <!-- 显式配置Servlet映射 -->
  <servlet>
      <servlet-name>SecurityServlet</servlet-name>
      <servlet-class>你的完整包名.Security</servlet-class>
  </servlet>
  <servlet-mapping>
      <servlet-name>SecurityServlet</servlet-name>
      <url-pattern>/login</url-pattern>
      <url-pattern>/logout</url-pattern>
  </servlet-mapping>
</web-app>

3. 确认容器注解扫描正常 #

如果使用@WebServlet注解，需确保web.xml中没有设置metadata-complete="true"（该属性会关闭注解扫描）。Jakarta EE 5.0默认开启注解扫描，若有此属性请删除。

4. 验证Servlet部署状态 #

• 检查服务器部署目录（如Tomcat的webapps/balance/WEB-INF/classes），确认Security.class文件存在于对应包路径下。
• 直接访问http://localhost:8080/balance/login，若能正常显示内容，说明Servlet本身无问题，仅需调整欢迎页逻辑；若仍空白，重点排查Servlet代码或类加载问题。

5. 排查隐藏异常 #

查看服务器日志（如Tomcat的logs/catalina.out），检查是否有Servlet加载失败、权限不足等隐性错误。

内容的提问来源于stack exchange，提问作者Lim Nabong