Java ProcessBuilder配置多目录classpath报NoClassDefFoundError

按优先级从高到低排查以下问题点：

• 路径前缀不匹配：代码中classpath写的是相对路径user/WEB-INF/...，但终端可正常运行的命令用的是绝对路径/user/WEB-INF/...，开头少了根路径标识/，子进程启动后根本定位不到对应lib目录。
• 工作目录不一致：Runtime.exec启动子进程时默认继承当前主Java进程的工作目录，和你手动在终端执行命令时所在的目录大概率不匹配，就算路径前缀正确，相对路径也会指向错误位置。
• 通配符/参数解析失效：通过/bin/sh -c拼接字符串传参存在两个隐患：一是如果拼接逻辑没有正确处理引号，classpath里的*不会被shell展开（JVM本身不会主动解析路径通配符，通配符展开是shell的能力）；二是如果路径包含空格、特殊字符，字符串会被shell拆分成多个参数，导致-cp后拿到的类路径被截断。
• 类加载顺序冲突：检查代码中classpath的路径顺序和终端执行时的顺序是否一致，是否存在同名不同版本的依赖被优先加载导致类初始化失败，该问题概率较低。

• 第一步：统一使用绝对路径配置classpath，和你终端验证通过的路径完全一致，不要使用相对路径，修正后的classpath配置如下：

command.add(
 "/user/WEB-INF/thirdpartyLib/*" + ":" +
 "/user/WEB-INF/lib/*" + ":."
);

• 第二步：直接使用ProcessBuilder传递参数列表，放弃/bin/sh -c拼接字符串的写法，避免shell转义、参数拆分的问题，同时显式指定子进程工作目录，参考实现：

List<String> command = new ArrayList<>();
command.add("java");
command.add("-cp");
command.add("/user/WEB-INF/thirdpartyLib/*:/user/WEB-INF/lib/*:.");
command.add("com.test.process.Test1");

ProcessBuilder pb = new ProcessBuilder(command);
// 替换为你实际需要的子进程工作目录
pb.directory(new File("/你的服务运行根路径"));
// 合并标准错误流和标准输出流，方便后续排查日志
pb.redirectErrorStream(true);
Process process = pb.start();

• 第三步：如果调整后仍报错，在代码中打印子进程的实际工作目录、完整启动命令、系统环境变量中的CLASSPATH值，和终端可正常运行的环境逐字符对比，绝大多数场景下都是路径字符错误、目录权限问题导致。

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