使用FOP 2.10与JPMS转换FO至PDF遇模块描述符问题求解决方案

问题原因 #

这个错误源于JDK版本与项目模块配置不兼容：fop-core 2.10是包含module-info.class的模块化JAR，但项目要么未启用对应版本的模块系统，要么JDK版本达不到依赖要求（fop-core 2.10最低要求JDK11），导致Maven/Eclipse无法正确解析模块描述符。

具体解决步骤 #

1. 统一项目JDK版本 #

• 右键项目 → Properties → Java Build Path → Libraries：确认使用的JDK版本为11或更高，若版本不符，点击Add Library添加对应JDK并替换原有低版本JDK。
• 切换到Java Compiler选项卡，将Compiler compliance level设置为与Build Path一致的JDK版本（如11）。

2. 修改Maven配置跳过模块检测 #

在项目根目录的pom.xml中添加以下构建配置，让Maven和编译器跳过模块描述符的自动推导：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>11</source>
                <target>11</target>
                <fork>true</fork>
                <compilerArgs>
                    <arg>--add-modules</arg>
                    <arg>ALL-MODULE-PATH</arg>
                    <arg>--disable-preview</arg>
                </compilerArgs>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.2</version>
            <configuration>
                <argLine>--add-modules ALL-MODULE-PATH --disable-preview</argLine>
            </configuration>
        </plugin>
    </plugins>
</build>

添加完成后，右键项目 → Maven → Update Project，勾选Force Update of Snapshots/Releases，点击OK同步依赖。

3. 调整Eclipse模块路径配置 #

如果项目被Eclipse误识别为模块化项目：

• 删除项目根目录下的module-info.java文件（若存在）。
• 右键项目 → Properties → Java Build Path：选中Modulepath下的所有依赖，右键选择Move to Classpath，将依赖移到类路径下。
• 再次执行Maven Update Project。

4. 清理重建项目 #

• 执行mvn clean install命令：可以在Eclipse中创建Maven运行配置（Run→Run Configurations），目标填写clean install，运行后清理旧构建文件并重新编译。
• 右键项目 → Project → Clean，选择当前项目清理Eclipse缓存。

验证方案 #

完成以上操作后，尝试运行项目主类。若仍有错误，检查本地Maven仓库中org/apache/xmlgraphics/fop-core/2.10目录下的JAR包是否完整，若不完整则删除该目录后重新执行Maven Update。

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