JavaFX项目集成Apache POI时触发java.lang.module.FindException：找不到org.slf4j模块的问题排查

这个启动层初始化错误的核心原因很明确：Apache POI的org.apache.poi.poi模块依赖了SLF4J日志框架，但你既没有在module-info.java中声明对SLF4J模块的依赖，也没有确保SLF4J的相关jar包已经被引入到项目里。

为什么会触发这个错误？ #

Java的模块系统（JPMS）是强依赖校验模式，所有模块之间的依赖关系必须显式声明在module-info.java中——哪怕是间接依赖也不能例外。org.apache.poi.poi在设计时就依赖SLF4J来处理日志输出，所以当你引入poi模块后，JVM启动时会自动检查它所需的所有依赖模块是否存在且被正确声明，找不到SLF4J模块就会抛出这个Module org.slf4j not found的错误。

具体解决步骤 #

1. 在module-info.java中添加SLF4J的依赖声明
   打开你的module-info.java，在现有声明下添加一行：

   requires org.slf4j;
   

   这会告诉模块系统，你的项目（以及依赖的poi模块）需要使用SLF4J模块。

2. 确保SLF4J的API jar包已被引入项目

   • 如果你用Maven/Gradle这类构建工具，直接在构建文件中添加SLF4J的依赖。比如Maven的pom.xml里可以加：

     <dependency>
         <groupId>org.slf4j</groupId>
         <artifactId>slf4j-api</artifactId>
         <!-- 注意版本要和你使用的Apache POI兼容，比如POI 5.x系列建议搭配SLF4J 2.x版本，可根据实际情况调整 -->
         <version>2.0.9</version>
     </dependency>
     

   • 如果你是手动管理jar包，需要下载SLF4J的API jar包（通常命名为slf4j-api-x.x.x.jar），将它放到项目的模块路径或类路径下。

3. 可选：添加SLF4J的日志实现（如果需要查看POI的日志）
   SLF4J只是一个日志门面，本身不会输出日志，需要搭配具体的日志实现（比如Logback、Log4j2等）才能看到POI运行时的日志信息。比如用Logback的话：

   • Maven依赖：

     <dependency>
         <groupId>ch.qos.logback</groupId>
         <artifactId>logback-classic</artifactId>
         <version>1.4.11</version>
     </dependency>
     

   • 同时在module-info.java中添加：

     requires ch.qos.logback.classic;
     

做完这些步骤后，再启动项目，那个启动层初始化错误应该就会消失了。

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