如何解决JasperReports自动模块名称不稳定问题（模块路径）

问题原因 #

JasperReports当前依赖包未包含module-info.java，JVM会将其识别为自动模块，模块名直接取自jar文件名（即jasperreports），这种名称不具备稳定性（比如jar文件名变更会导致模块名变化），因此IDE会抛出警告。

修复方案 #

方案1：升级到官方模块化版本 #

从JasperReports 6.20.0版本开始，官方已为核心jar包添加了module-info.java，稳定模块名为net.sf.jasperreports。你只需在Maven的pom.xml中升级依赖版本：

<dependency>
    <groupId>net.sf.jasperreports</groupId>
    <artifactId>jasperreports</artifactId>
    <version>6.20.0</version> <!-- 或更高稳定版本 -->
</dependency>

然后修改module-info.java中的依赖声明：

module TestApp {
    exports com.app.jsp;
    requires net.sf.jasperreports;
}

重新构建项目后，警告会自动消失，此时使用的是官方定义的稳定模块名。

方案2：用Moditect插件为现有jar添加模块信息 #

如果无法升级JasperReports版本，可通过Maven的Moditect插件在构建过程中为依赖jar注入module-info.java，指定稳定模块名：

1. 在pom.xml中添加Moditect插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.moditect</groupId>
            <artifactId>moditect-maven-plugin</artifactId>
            <version>1.0.0.Final</version>
            <executions>
                <execution>
                    <id>add-module-info-to-jasperreports</id>
                    <phase>package</phase>
                    <goals>
                        <goal>add-module-info</goal>
                    </goals>
                    <configuration>
                        <modules>
                            <module>
                                <artifact>
                                    <groupId>net.sf.jasperreports</groupId>
                                    <artifactId>jasperreports</artifactId>
                                    <version>${jasperreports.version}</version> <!-- 替换为你当前的版本 -->
                                </artifact>
                                <moduleInfo>
                                    module net.sf.jasperreports {
                                        exports net.sf.jasperreports.engine;
                                        exports net.sf.jasperreports.engine.data;
                                        exports net.sf.jasperreports.engine.export;
                                        // 根据你的实际使用需求添加需要导出的包
                                        requires transitive java.desktop;
                                        requires transitive java.sql;
                                        requires transitive org.apache.commons.logging;
                                        // 添加JasperReports依赖的其他模块
                                        opens net.sf.jasperreports.engine to com.app.jsp; // 如果你的代码需要反射访问Jasper内部类
                                    }
                                </moduleInfo>
                            </module>
                        </modules>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 修改module-info.java中的依赖声明为requires net.sf.jasperreports;，和方案1一致。
3. 执行mvn clean package，插件会自动处理JasperReports的jar包，添加模块信息后放入模块路径，消除警告。

方案3：Eclipse中临时指定自动模块名（不推荐，仅临时调试用） #

如果只是在Eclipse中临时消除警告，可手动为JasperReports的jar指定自动模块名：

• 右键项目 → Build Path → Configure Build Path
• 切换到Modules标签页，找到jasperreports模块
• 点击Edit，在Module name字段输入net.sf.jasperreports
• 点击Apply and Close

但这种方式仅在本地IDE生效，Maven构建时不会保留，因此不推荐作为长期解决方案。

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