JavaFX启动层初始化报错：跨设备运行遇模块导出冲突

错误原因 #

这个问题源于Java模块系统的核心约束：同一个包不能被多个模块同时导出给同一目标模块。这里hamcrest.core和junit两个模块都包含org.hamcrest.internal包，且都尝试将该包导出给json.simple，直接触发了模块解析冲突。

具体修复步骤 #

1. 升级JUnit版本，避免内嵌Hamcrest包 #

较新的JUnit 5已不再内嵌Hamcrest的重复包，建议直接升级到JUnit 5并单独引入Hamcrest依赖，从根源解决冲突：

<!-- Maven 配置示例 -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.9.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.9.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.hamcrest</groupId>
    <artifactId>hamcrest-core</artifactId>
    <version>2.2</version>
    <scope>test</scope>
</dependency>

2. 调整Module-info.java的声明规则 #

如果必须保留JUnit 4，修改module-info.java，明确限制重复包的导出范围：

module your.module.name {
    requires json.simple;
    requires junit;
    requires hamcrest.core;

    // 仅允许hamcrest.core使用该包，阻止junit向外导出
    exports org.hamcrest.internal to hamcrest.core;
}

或者通过static关键字控制依赖传递，避免间接引入冲突包：

module your.module.name {
    requires json.simple;
    requires static junit;
    requires hamcrest.core;
}

3. 排除依赖中的重复包 #

在构建工具中移除JUnit依赖自带的Hamcrest模块，只保留独立的Hamcrest依赖：

<!-- Maven 排除重复依赖示例 -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.13.2</version>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.hamcrest</groupId>
            <artifactId>hamcrest-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.hamcrest</groupId>
    <artifactId>hamcrest-core</artifactId>
    <version>2.2</version>
    <scope>test</scope>
</dependency>

4. 清理目标设备的依赖缓存 #

本地运行正常但其他设备出错，大概率是目标设备的依赖缓存存在旧版本冲突包，执行以下命令强制更新：

• Maven：mvn clean install -U
• Gradle：gradle clean build --refresh-dependencies

内容的提问来源于stack exchange，提问作者Lloyd Jayson Pintac