Servlet监听器执行异常：CommonData类未加载问题求助

针对你遇到的「本地运行Web应用后看不到CommonData监听器加载日志、访问控制器时发现它未生效，且之前出现过failed to execute servlet listener异常」的问题，结合你提供的web.xml配置，我整理了几个实用的排查方向：

1. 确认CommonData类是否符合Servlet监听器规范 #

Servlet容器只会加载实现了javax.servlet.ServletContextListener接口（或Servlet 3.0+使用@WebListener注解）的类作为监听器。如果你的CommonData没有满足这个要求，容器会直接跳过加载，甚至触发类转换异常（这很可能是你之前遇到failed to execute servlet listener的原因）。

检查代码示例：

// 正确的监听器实现方式
public class CommonData implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        // 务必添加初始化日志，方便排查
        System.out.println("[CommonData] 监听器初始化完成");
        // 或者用日志框架输出更规范的日志
        // LoggerFactory.getLogger(CommonData.class).info("CommonData监听器已初始化");
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 可选：添加资源销毁逻辑
    }
}

2. 检查类路径与依赖完整性 #

• 确认CommonData类已经被正确编译到项目输出目录（比如IntelliJ的target/classes或out/production/classes），没有编译错误。
• 如果该类来自外部依赖包，检查依赖是否正确引入，且在Web应用的WEB-INF/lib目录下能找到对应jar包（本地运行时IntelliJ通常会自动处理，但如果依赖范围设为provided，可能导致本地环境缺失）。

3. 调整日志级别，捕获隐藏细节 #

你看不到加载日志，大概率是日志级别过高导致关键信息被过滤：

• 把Log4j的日志级别调低到DEBUG或TRACE，重点关注org.springframework.web和javax.servlet相关的日志输出，能看到容器加载监听器的完整流程，包括是否尝试加载CommonData、有没有被吞掉的异常。
• 同时检查IntelliJ的Run控制台是否开启了日志过滤，确保没有隐藏DEBUG级别的日志。

4. 排查监听器启动顺序与Spring上下文依赖 #

你的web.xml中同时配置了Spring的ContextLoaderListener和自定义的CommonData监听器，监听器的加载顺序严格遵循web.xml中的定义顺序：

• 如果CommonData的初始化逻辑依赖Spring上下文里的Bean，那它会在Spring上下文初始化前执行，此时会因依赖缺失失败，且可能因为异常处理机制导致日志未输出。
• 解决方法：把CommonData监听器的配置放到ContextLoaderListener之后，或者在contextInitialized方法中等待Spring上下文初始化完成后再执行逻辑。

5. 清理IntelliJ缓存与检查运行配置 #

• 有时候IntelliJ的缓存会导致类文件未更新，尝试执行「File -> Invalidate Caches...」清理缓存，然后重新编译项目。
• 确认运行配置中选择了正确的Web模块，Deployment配置里已包含WEB-INF/web.xml和相关类文件。

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