Java 1.6遗留项目自定义包存在但编译Servlet时提示不存在求助

• 检查编译命令的类路径参数
  手动编译Servlet时，javac的-cp（或-classpath）参数优先级高于系统CLASSPATH，很可能因为环境升级后，编译脚本里的相对路径失效。比如自定义包的class文件输出在./bin目录，编译MyServlet时要显式指定类路径：

  javac -cp ./bin MyServlet.java
  

  同时确认编译脚本的执行工作目录是否和之前一致，避免相对路径指向错误的位置。

• 验证Tomcat类加载配置
  Java 1.6对应的Tomcat版本（如6.x/7.x）有固定的类加载顺序，若自定义包的类放在Tomcat的common/lib或shared/lib，升级后catalina.properties里的shared.loader配置可能被重置，导致Web应用类加载器无法找到这些类。
  优先确保自定义包的class文件放在Web应用的WEB-INF/classes/test/package/路径下，或打包成jar放入WEB-INF/lib，这是Web应用类加载器优先加载的位置。

• 统一JDK编译环境
  即使同为Java 1.6，不同发行版（Oracle JDK/OpenJDK）的类文件处理可能存在细微差异。确保编译自定义包和Servlet时使用同一个JDK的javac命令，同时显式指定版本参数避免兼容性问题：

  javac -source 1.6 -target 1.6 test/package/MyClass.java
  javac -source 1.6 -target 1.6 -cp ./bin MyServlet.java
  

• 排查CLASSPATH隐性覆盖
  Tomcat启动脚本会重置自身的CLASSPATH，忽略系统环境变量的配置。编译Servlet时不要依赖系统CLASSPATH，始终显式通过-cp参数指定所需类路径。如果使用Ant等构建工具，检查build.xml中的classpath节点是否正确引入了自定义包的输出目录或jar包。

• 核对包名与目录的大小写
  若应用从Windows迁移到Linux环境，需注意目录名与包名的大小写必须完全匹配。比如包名是test.package，对应的目录必须是test/package/，不能出现Test/Package/这类大小写不一致的情况，Linux文件系统是严格区分大小写的。

• 清理编译缓存
  清理Tomcatwork/Catalina/localhost/[你的应用名称]目录下的缓存文件，同时删除项目编译输出目录（如bin、classes）里的旧class文件，重新编译所有类，避免旧缓存导致的加载异常。

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