Maven构建成功但编译类含未解析类型错误求助

1. 检查Servlet API依赖的Scope与冲突 #

• 确认javax.servlet-api和jakarta.servlet-api的<scope>配置：Servlet API通常由应用服务器提供，正确的scope应为provided。如果其中一个或两个都设为compile，会导致编译阶段类路径中同时存在两套Servlet API（javax.servlet和jakarta.servlet），引发类识别混淆，可能出现编译成功但生成的类文件存在隐式错误。
• 执行mvn dependency:tree命令，查看编译阶段实际生效的依赖树，确认javax.servlet-api是否被正确引入，是否有被jakarta.servlet-api的依赖规则排除或覆盖。

2. 验证反编译工具的准确性 #

反编译工具（如JD-GUI、Fernflower）在依赖类缺失时可能出现解析错误，导致显示虚假的编译问题：

• 使用javap命令直接分析类文件字节码，执行javap -c path/to/XSSFilter.class，查看类的实际结构（是否实现Filter接口、方法签名是否正确），以此判断是类文件真的有问题，还是反编译工具的误报。
• 更换其他反编译工具重新解析类文件，对比结果。

3. 检查XSSFilter类的接口实现与编译逻辑 #

• 确认源文件中XSSFilter类是否明确声明实现Filter接口（如public class XSSFilter implements Filter），反编译结果中未显示接口实现，可能是编译时未找到Filter接口，但Maven编译成功的矛盾点说明大概率是反编译问题，仍需核对源文件代码。
• 查看Maven编译日志（执行mvn clean install -X开启 debug 日志），搜索XSSFilter相关的编译过程，确认编译时是否正确加载了javax.servlet.Filter类。

4. 排查Maven编译插件配置 #

• 检查maven-compiler-plugin的版本及配置，确保source和target版本与项目JDK版本匹配，避免因版本兼容问题导致编译时类处理异常。
• 确认编译插件是否存在特殊配置（如自定义类路径），导致编译时未正确引入Servlet API依赖。

5. 结合JBoss运行机制分析 #

JBoss部署后能正常运行，是因为服务器自身提供了Servlet API（新版本JBoss默认使用Jakarta EE规范的jakarta.servlet包），运行时类加载器会优先加载服务器提供的类，弥补了编译阶段类文件可能存在的依赖引用问题。可进一步查看JBoss的部署日志，确认运行时加载的Servlet API版本，反向推导编译阶段的依赖问题。

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