Windows10下Eclipse2020集成CPLEX运行Java应用报类加载错误问题

• 核心根因：Eclipse 2020版本默认适配Java 9+模块化系统（JPMS），你引入的cplex.jar被默认挂载到**模块路径（Module Path）**而非传统类路径（Class Path），违反了JPMS的类加载隔离规则：
  无模块声明的普通Java应用，无法直接访问模块路径下未被显式依赖声明的第三方类。即使项目Referenced Libraries列表中能看到cplex.jar，只要它位于模块路径、且项目没有写对应的module-info.java依赖声明，JVM的系统类加载器就不会把这些类纳入可访问的类加载范围，最终触发NoClassDefFoundError。
• 为什么没直接调用IloNumExpr还会报错：ilog.concert.IloNumExpr是CPLEX Concert API的核心基类，所有CPLEX Java API的初始化逻辑（比如创建IloCplex实例）都会隐式依赖该类，属于运行时类加载链路的必经节点，不需要业务代码显式import就会触发类加载流程。
• 你观察到的“类加载路径仅包含项目编译输出目录”是直接佐证：Eclipse运行配置会自动从系统类加载路径剥离所有挂载在模块路径下的类库，不会主动把模块路径的jar加入传统类加载范围。

• 修正类库挂载路径，关闭不必要的模块化支持
  操作路径：右键proj1项目→Properties→Java Build Path→Libraries标签页
  1. 找到当前挂载在Module Path分组下的cplex.jar，选中后点击Remove彻底移除
  2. 重新点击Add External JARs，选择本地对应版本的cplex.jar，确保最终引入后cplex.jar显示在Classpath分组下，而非Module Path
  3. 检查项目根目录，如果存在自动生成的module-info.java文件，直接删除，完全关闭项目的模块化适配，回到传统Java应用的类加载逻辑（这是对未做模块适配的老版本第三方库兼容性最好的配置方式）
• 校验运行配置的类加载规则
  打开对应程序的Run Configuration→Classpath标签页
  1. 确认Project条目下正确关联了proj1的编译输出目录
  2. 确认User Entries分组下存在cplex.jar的引用，如果缺失则手动通过Add External JARs补上，不要依赖模块路径间接引入
  3. 核对VM参数中的-Djava.library.path值，确保路径完全指向cplex1290.dll所在的实际安装目录（即CPLEX安装目录下win64_x64/bin的完整路径，不要指向层级不符的上层/下层目录）
• 验证最终启动命令合法性
  在Run Configuration页面点击Show Command Line，核对生成的实际启动参数：
  • 必须看到-cp（类路径参数）后依次拼接项目编译输出目录、cplex.jar的完整本地路径
  • 确认启动命令中不存在--module-path/-p参数后拼接cplex.jar的写法，也不存在相关的--add-modules模块加载参数
• 额外版本校验
  确认本地引入的cplex.jar版本与cplex1290.dll版本完全匹配（均为CPLEX 2020即12.9.0版本），避免出现64位JDK搭配32位原生库、jar与dll小版本不一致的情况，这类不匹配同样会在类初始化阶段触发找不到依赖类的报错。

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