Gradle刷新Eclipse项目后java.smartcardio库被移除的永久解决方法

问题表现 #

• 手动通过右键 > Build Path > Configure Build Path > Module Dependencies路径为Eclipse项目添加java.smartcardio库后，执行右键 > Gradle > Refresh Gradle Project操作时，该库会被自动从构建路径移除。
• 配置正常生效时，.classpath文件中JRE容器的classpath条目会携带模块属性，limit-modules参数值包含java.smartcardio；执行Gradle刷新后，该条目下的所有属性会被清空，仅保留空的classpathentry标签。
• 此前尝试在Gradle配置中手动写入limit-modules全量值的方案无法生效，且不同开发者手动添加模块时，自动生成的limit-modules填充内容存在差异。
• 现有公开渠道中同问题的参考方案无法解决当前场景的问题。

根本原因 #

所有手动在Eclipse Build Path中做的配置，都会在Gradle刷新时被Buildship插件重新生成的配置覆盖。此前自行编写的Gradle配置失效有两个核心原因：

1. 全量写死limit-modules列表仅保留java.se和java.smartcardio，会删掉当前JDK默认加载的其他扩展模块，不符合Eclipse的配置生成逻辑；不同开发者使用的JDK版本不同，默认带的扩展模块列表有差异，这就是手动配置时limit-modules内容不一致的原因。
2. 部分版本的Buildship插件会在默认的whenMerged钩子执行完成后，再次重写JRE容器的属性，导致提前写入的配置被覆盖。

解决方案 #

方案1：修正Gradle配置（通用场景推荐） #

不要硬编码全量limit-modules列表，改为在插件生成的原有模块列表基础上追加java.smartcardio，避免覆盖其他默认模块，配置写入项目的build.gradle文件即可：

eclipse {
    classpath {
        file {
            whenMerged { classpath ->
                // 定位Eclipse中的JRE容器classpath条目
                def jreEntry = entries.find { it.path.contains('org.eclipse.jdt.launching.JRE_CONTAINER') }
                if (jreEntry) {
                    jreEntry.entryAttributes['module'] = 'true'
                    // 读取插件默认生成的模块列表，不存在则以java.se为基础
                    def originModules = jreEntry.entryAttributes['limit-modules'] ?: 'java.se'
                    // 避免重复追加smartcardio模块
                    if (!originModules.contains('java.smartcardio')) {
                        jreEntry.entryAttributes['limit-modules'] = originModules + ',java.smartcardio'
                    }
                }
            }
        }
    }
}

配置写入后执行一次Gradle项目刷新，后续无论刷新多少次，java.smartcardio模块都会被自动追加到模块列表中，不会丢失，同时兼容不同版本的JDK和Buildship插件。

方案2：模块化项目专属方案 #

如果你的项目是Java 9+模块化项目，根目录存在module-info.java文件，不需要修改Gradle配置，直接在模块声明文件中添加依赖即可：

module 你的项目模块名 {
    requires java.smartcardio;
    // 其余原有requires声明保持不变
}

Gradle刷新时会自动识别module-info.java中的依赖声明，自动把java.smartcardio加入构建路径，不会被清理。

注意：不要直接手动修改.classpath文件做持久化配置，所有Eclipse相关的构建配置都要通过Gradle的eclipse插件生成，否则刷新时必然被覆盖。

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