Java 6遗留项目使用NetBeans 8.1新增类导入无法解析问题求助

• 核对项目源码目录配置：打开项目属性-「源」标签页，确认包B所在的目录被标记为源包（Source Package），而非测试包、排除目录或资源目录。NetBeans 8.x对源目录的判定逻辑僵化，未纳入编译路径的目录会出现IDE能识别语法，但实际编译时找不到类的问题，和你遇到的IDE无报错仅clean and build失败的特征匹配。
• 检查构建脚本规则：若为Ant项目，打开根目录build.xml，搜索<javac>相关配置，查看是否存在针对包B路径的exclude过滤规则；若为Maven项目，检查pom.xml的<build>节点下是否配置了<excludes>规则仅编译包A路径的代码。这类构建脚本规则不会被IDE的实时语法检查读取，因此不会触发界面标红。
• 排查GWT模块配置：如果项目集成GWT，检查所有.gwt.xml模块配置文件中的<source>标签，该标签用于指定GWT需要编译为前端代码的Java包路径，未被纳入的包会被GWT编译器拦截，部分2.x版本的GWT插件存在误校验非GWT业务代码的问题，会触发无意义的导入报错。
• 验证包名合规性：检查包B的完整命名是否包含Java关键字、特殊字符，或与JDK内置包名重名（比如以java./javax.作为自定义包前缀），Java 6编译器对这类不规范包名的容错性极低，经常出现偶发的导入解析失败问题。
• 清空NetBeans本地缓存：关闭IDE后删除用户目录下NetBeans/8.1/var/cache文件夹的全部内容，重启后重新构建。NetBeans 8.1的缓存同步Bug非常多，控制台出现黑白报错而非红色错误提示，就是缓存未同步编译错误标识的典型表现。
• 手动命令行编译验证：直接使用JDK 6的javac命令，带上项目完整classpath参数单独编译包B下的新增类，如果命令行编译正常，即可确定问题出在NetBeans IDE配置或项目的IDE适配规则，与代码本身无关。

这类问题在NetBeans 8.x + Java 6 + GWT 2.x的技术栈下属于高频出现的已知问题，核心诱因有两个：

• 当时的IDE、构建插件、第三方组件的规则隔离能力较差，IDE实时语法检查和实际构建流程的规则不同步是常态，很多项目常年不新增代码，构建脚本里的历史排除规则无人维护，首次新增文件就会触发限制。
• NetBeans 8.1本身存在多个和增量编译、包路径扫描相关的公开Bug，后续小版本有修复，但对于不能升级环境的遗留项目，只能通过调整配置规避。

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