Java -cp lib/* 失效主因是shell未展开通配符或JVM不支持:Linux/macOS需bash支持,Windows cmd完全不展开;应显式列出JAR或用find+tr动态拼接,OpenJDK 14+虽支持--enable-preview但生产禁用。

Java -cp 参数不生效,lib目录里的JAR没被加载
直接用 java -cp lib/* MyApp 在某些 JDK 版本(尤其是 OpenJDK 11+)上会失败,报 NoClassDefFoundError 或 ClassNotFoundException。这不是路径写错了,而是 shell 展开行为和 JVM 对 * 的处理逻辑不一致导致的。
Linux/macOS 下,lib/* 是由 shell 展开成多个路径,但旧版 bash 或某些精简 shell(如 dash)可能不支持通配符展开;Windows cmd 根本不支持 * 展开,java -cp lib\* MyApp 会被当字面量传给 JVM,自然找不到类。
- 稳妥做法是显式列出所有 JAR:
java -cp "lib/a.jar:lib/b.jar:lib/c.jar" MyApp(Linux/macOS)或java -cp "lib\a.jar;lib\b.jar;lib\c.jar" MyApp(Windows) - 更实用的是用
find+tr动态拼接(Linux/macOS):java -cp "$(find lib -name '*.jar' | tr '\n' ':' | sed 's/:$//')" MyApp - 如果用 OpenJDK 14+,可启用
--class-path的 glob 支持(需加--enable-preview),但生产环境不建议依赖预览特性
MANIFEST.MF 中 Class-Path 路径写相对还是绝对?
打包成 myapp.jar 后,想让它自动加载 lib/ 下的依赖,必须在 META-INF/MANIFEST.MF 里写 Class-Path: 行。这里路径必须是相对于 myapp.jar 所在位置的相对路径,不是相对于项目根目录或 src 目录。
比如你把 myapp.jar 和 lib/ 放在同一级目录下,lib/ 里有 guava.jar,那么 MANIFEST 写的就是:Class-Path: lib/guava.jar。如果运行命令是 java -jar myapp.jar,且当前目录是 /opt/app/,那 JVM 就会去 /opt/app/lib/guava.jar 找。
- 路径分隔符统一用
/,即使在 Windows 上也别用\,JVM 自己会适配 - 多个 JAR 用空格分隔,不是冒号或分号:
Class-Path: lib/a.jar lib/b.jar lib/c.jar - 路径不能包含
..向上跳转,JVM 为安全默认禁用
用 java -Djava.ext.dirs 启动时为什么反而出错?
-Djava.ext.dirs 是个危险参数。它会完全替换 JVM 默认的扩展目录(如 $JAVA_HOME/jre/lib/ext),一旦你只指定 lib/,JVM 就找不到 sun.*、javax.* 等核心类,直接抛 NoClassDefFoundError: java/lang/Object —— 连最基础的类都加载不了。
这个参数早在 Java 9 就被标记为 deprecated,Java 17 已彻底移除。别碰它。
- 替代方案只有两个:
-cp(启动时指定)或Class-Path(打包进 MANIFEST) - 如果真要全局加依赖(比如监控 agent),用
-javaagent或--add-modules(模块化场景) - Spring Boot 的
fat jar之所以能“自带 lib”,靠的是自定义 ClassLoader,不是靠 JVM 原生机制
Tomcat 部署 WAR 时 lib 目录放哪才有效?
Tomcat 不认你项目根目录下的 lib/。它只加载两个地方的 JAR:WEB-INF/lib/(每个应用私有)和 $CATALINA_HOME/lib/(全局共享)。
如果你的应用是手动打包的 WAR,确保所有第三方 JAR 都放进 WEB-INF/lib/,而不是项目顶层的 lib/。否则 Tomcat 启动时根本不会扫描它们。
- 用 Maven 构建时,
mvn package默认就把dependencies打进WEB-INF/lib/,不用额外操作 - 手动生成 WAR:先
mkdir -p WEB-INF/lib,再cp *.jar WEB-INF/lib/,最后jar -cf myapp.war * - 不要把 JAR 放到
WEB-INF/classes/lib/或resources/lib/,这些路径对 ClassLoader 无效
部署外部 lib 目录的核心就一条:JVM 只认它明确被告知的位置。没有“自动发现”这回事,也没有“约定优于配置”的宽容。路径写错一位、分隔符用错一个、MANIFEST 换行少个空格,都会让整个 classpath 失效。最稳妥的方式永远是——自己拼好完整路径,然后 echo $CLASSPATH 或用 jps -vl 确认实际传给 JVM 的是什么。


















