升级Java/Gradle后出现InaccessibleObjectException错误的解决咨询

成因分析 #

1. JDK模块系统反射限制收紧：Java 9引入JPMS（Java平台模块系统）后，默认限制反射对非公共类成员的访问；JDK 16及后续版本进一步强化了这一规则，JDK 19延续了严格的访问控制。你的旧测试代码大概率依赖反射访问私有字段、方法或构造器，在JDK 14时宽松的默认规则允许这类操作，但升级到19后被直接拦截。
2. Lombok适配不彻底：虽然已升级Lombok版本，但如果测试代码通过反射访问Lombok生成的私有成员（比如@Data注解生成的私有字段），且Lombok配置未适配高版本JDK，也会触发该异常。

解决方法 #

1. 给测试任务添加JVM参数放宽反射访问 #

在Gradle的build.gradle（或build.gradle.kts）中，针对测试任务添加--add-opens参数，允许目标包/类的反射访问：

test {
    jvmArgs += [
        // 示例：允许反射访问java.lang包下的类
        "--add-opens", "java.base/java.lang=ALL-UNNAMED",
        // 替换为你的项目包路径，允许无命名模块访问
        "--add-opens", "com/yourcompany/yourpackage=ALL-UNNAMED"
    ]
}

如果是模块化项目（存在module-info.java），需将ALL-UNNAMED替换为测试代码所在的模块名。

2. 修改测试代码，避免直接反射私有成员 #

• 若测试的是自身代码的私有成员：将成员权限改为protected，或在同包下添加包级别的访问方法，直接用公共API替代反射。
• 若测试的是第三方库的私有成员：优先改用库提供的公共API；如果无法替代，需确认库是否有适配JDK 16+的版本，或通过--add-opens临时放宽限制。

3. 优化Lombok配置适配JDK 19 #

在项目根目录的lombok.config文件中添加以下配置，确保Lombok生成的代码适配高版本JDK：

lombok.jdk.version=19
lombok.accessors.chain=true

同时，尽量用Lombok生成的getter/setter等公共方法访问成员，而非直接反射私有字段。

4. 检查Gradle测试任务的参数传递 #

确保没有其他插件（如JaCoCo、SonarQube）覆盖或干扰测试任务的JVM参数，确认--add-opens参数已正确传递给测试进程。

示例参考 #

错误栈示例 #

java.lang.reflect.InaccessibleObjectException: Unable to make field private java.lang.String com.example.User.name accessible: module com.example does not "opens com.example" to unnamed module @7a81197d
    at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:354)
    at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:297)
    at java.base/java.lang.reflect.Field.checkCanSetAccessible(Field.java:178)
    at java.base/java.lang.reflect.Field.setAccessible(Field.java:172)
    at com.example.UserTest.testPrivateField(UserTest.java:16)

测试代码片段示例 #

public class UserTest {
    @Test
    void testPrivateField() throws NoSuchFieldException, IllegalAccessException {
        User user = new User();
        Field nameField = User.class.getDeclaredField("name");
        nameField.setAccessible(true); // 此处触发异常
        nameField.set(user, "test");
        assertEquals("test", user.getName());
    }
}

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