MyEclipse Filter和Listener自动生成及web.xml配置

MyEclipse 自动生成的 Filter 和 Listener 类，很多时候写好之后根本没反应——请求依然畅行无阻，控制台也不输出任何日志。这不是你代码写错了，而是容器根本没认出来。问题通常出在哪？一句话：要么注解没被扫到，要么 web.xml 没注册。下面把几个常见坑和标准解法梳理清楚。

MyEclipse 自动生成的 Filter 和 Listener 类默认不生效，必须确认是否完成 web.xml 注册或启用注解扫描——否则控制台不会输出任何日志，请求也不会被拦截或监听。

Filter 自动生成后为什么没拦截请求？

MyEclipse 创建 Filter 时会生成带 @WebFilter 注解的类（比如 @WebFilter("/TestServlet")），但这个注解只在 Servlet 3.0+ 容器且启用了注解扫描时才管用。如果发现加了注解却没用，先检查下面几个常犯错误：

• 项目 facet 版本低于 3.0（比如设成 2.5）→ 注解直接被忽略，这时必须改用 web.xml 配置才能生效。
• Tomcat 运行时没开启注解处理——虽然少见，但嵌入式 Tomcat 或某些旧版本确实可能禁掉。
• @WebFilter 的路径写错，比如漏了开头的斜杠：@WebFilter("TestServlet") 匹配不到任何请求，正确写法应该是 @WebFilter("/TestServlet") 或者 @WebFilter("/*")。
• 过滤器类没放在 src 下的正确包路径，导致编译后根本没被加载到容器里。

最稳妥的做法：右键项目 → Properties → Project Facets → 把 Dynamic Web Module 设为 3.0 或更高，同时检查 web.xml 的 version="3.0" 声明是否跟 facet 匹配。

Listener 在 MyEclipse 中创建后无输出？检查初始化时机

新建 Listener（比如实现 ServletContextListener）后，contextInitialized() 方法只在应用启动时跑一次。如果控制台啥都没打印，说明监听器压根没被容器识别——接下来逐个排查：

• 有没有在 web.xml 里声明 ？即使加了 @WebListener 注解，也要确认 Servlet 版本支持注解。
• 监听器类的名字拼写错了？ 的值得是全限定名，比如 com.example.MyListener 而不是 MyListener。
• 项目部署时有没有异常？比如类找不到、构造方法抛异常都会导致实例化失败，但 Tomcat 默认不报明显错误。
• 如果用了 HttpSessionListener，但还没访问任何 JSP/Servlet，或者浏览器禁用了 Cookie，session 根本不会创建，监听器自然没反应。

建议在 contextInitialized() 开头加一行 System.out.println("MyListener init OK");，然后确保服务器是干净重启（不是热更新），这样才能验证是否加载成功。

web.xml 中 filter 和 listener 的顺序影响实际行为吗？

顺序不影响加载的先后逻辑，但会影响配置的合法性——这点容易踩坑：

• 必须出现在对应的 之后，否则解析失败，Tomcat 启动就报错：“filter-name not found”。
• 放在 web.xml 任意位置都行，但推荐放在 后面、 前面，这样符合逻辑依赖——监听器经常需要读取 context-param。
• 多个 按 web.xml 中定义的顺序依次执行；多个 也按定义顺序触发 contextInitialized()。
• 和 之间没有执行依赖，但监听器早于过滤器初始化——先有 ServletContext，再挂过滤器链。

典型的陷阱：把 放到 前面，MyEclipse 不报错，但部署到 Tomcat 直接启动失败，错误信息是 java.lang.IllegalArgumentException: filter-name xxx not found。

为什么改了 Filter 代码却看不到新日志？

不是代码本身的逻辑问题，而是 MyEclipse 的部署缓存机制在作祟：

• 修改 Java 类后只刷新浏览器，不会重新加载类——必须重启 Tomcat（或者至少发布模块）。
• 如果用 “Publish” 功能而不是重启，MyEclipse 可能跳过 class 文件的更新，尤其是当类路径包含空格或特殊字符时。
• 过滤器的 init() 方法只在首次加载时调用一次，后面修改 doFilter() 并不会影响已经初始化好的实例——必须重启才能让新逻辑生效。
• 检查 build/classes 目录下对应的 .class 文件时间戳有没有更新，如果没有，说明编译根本没成功。

最简验证方法：删掉 doFilter() 里所有逻辑，只留一行 System.out.println("hit");，然后彻底关闭 Tomcat → 清理工作目录（Tomcat/work/Catalina/localhost/yourapp）→ 重启 → 访问资源看是否输出。这能绕过一切缓存干扰。

还有一个容易被忽略的点：MyEclipse 自动生成的 Filter/Listener 类，其父类或接口的导入语句可能因为 JDK 版本或 Server Runtime 设置不匹配而静默失败——比如用了 Servlet 4.0 的接口，但配置的是 Tomcat 7（只支持 3.0），编译通过但运行时报 NoClassDefFoundError，而且日志相当不明显。这种情况下排查顺序：先确认版本兼容性，再检查类路径和依赖库。