本文详解 java.lang.module.FindException: Module processed.jcommander not found 错误成因与修复方法，聚焦于 Java 模块路径（Modulepath）与类路径（Classpath）混淆导致的 Selenium 初始化失败问题。
本文详解 `java.lang.module.findexception: module processed.jcommander not found` 错误成因与修复方法，聚焦于 java 模块路径（modulepath）与类路径（classpath）混淆导致的 selenium 初始化失败问题。
在使用 Java 11 或更高版本（默认启用模块系统）运行 Selenium 4.x 项目时，若出现如下启动异常：
Error occurred during initialization of boot layer java.lang.module.FindException: Module processed.jcommander not found, required by org.seleniumhq.selenium.remote_driver
其根本原因并非 jcommander 缺失，而是 JVM 尝试将 Selenium 及其依赖（如 processed.jcommander）作为命名模块加载，但这些 JAR 实际上并未声明 module-info.class，也不符合 JPMS（Java Platform Module System）规范。Selenium 官方发布的标准 JAR（如 selenium-remote-driver-4.18.1.jar）属于自动模块（automatic module），仅能通过 Classpath 正确加载；一旦被错误地添加至 Modulepath，JVM 就会强制解析其模块名并查找缺失的 requires 模块，从而触发该异常。
✅ 正确修复步骤
1. 移除或禁用 module-info.java
如果你的项目根目录下存在 src/main/java/module-info.java（例如手动添加了模块声明），请直接删除该文件。Selenium 本身不支持强封装模块化部署，混合使用显式模块声明与传统库 JAR 会引发模块解析冲突。除非你已完整模块化整个项目（包括所有第三方依赖并为其提供 module-info.java），否则应保持项目为“无模块”（unnamed module）状态。
2. 确保 Selenium JAR 在 Classpath，而非 Modulepath
在主流 IDE 中需手动校正：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- Eclipse：右键项目 → Properties → Java Build Path → Libraries 标签页 → 展开对应 Selenium JAR → 查看其 Path 类型。若显示为 "Modulepath"，点击右侧 Remove，然后点击 Add External JARs... 重新从 Classpath 添加。
- IntelliJ IDEA：打开 Project Structure (Ctrl+Alt+Shift+S) → Modules → Dependencies 标签页 → 找到 selenium 相关 JAR → 将其 Scope 改为 "Compile"（对应 Classpath），确保 Module dependency 列为空。
? 验证技巧：在命令行中运行 java --list-modules | grep jcommander，若无输出，说明未以模块方式加载；再执行 java -cp "selenium-java-4.18.1.jar:..." YourTest 应可正常启动。
3. 构建工具配置示例（Maven）
确保 pom.xml 中未启用模块相关插件（如 maven-jmod-plugin），且依赖声明标准：
<dependency>
<groupId>org.seleniumhq.selenium</groupId>
<artifactId>selenium-java</artifactId>
<version>4.18.1</version> <!-- 推荐使用最新稳定版 -->
</dependency>Maven 默认将依赖置于 Classpath，无需额外配置 —— 该错误通常只在 IDE 手动误配或使用 jlink/jdeps 工具链时发生。
⚠️ 注意事项
- 不要尝试为 jcommander 或其他 Selenium 依赖单独下载“模块化版本”：社区并无官方 JPMS 兼容包，强行重打包易引入兼容性风险；
- 若使用 Spring Boot，确保 spring-boot-maven-plugin 的 repackage 目标未意外启用模块模式（检查 pom.xml 中 <classifier>exec</classifier> 或 jvmArguments 是否含 --module-path）；
- JDK 17+ 用户请注意：--add-modules=ALL-SYSTEM 等参数无法解决此问题，因其仅影响系统模块，不影响应用级 JAR 解析逻辑。
✅ 总结
该异常本质是模块系统误用问题，核心解决逻辑始终围绕 “让非模块化库回归 Classpath”。遵循「删 module-info.java + 移 Selenium 至 Classpath」两步法，99% 的同类报错可即时消除。牢记：Selenium 是传统 JVM 库，不是模块化框架 —— 在模块时代，尊重它的设计边界，才是最稳健的实践。
