如何解决 Unable to make field private final java.lang.String java.io.File.path accessible: module java问题

如何解决 Unable to make field private final java.lang.String java.io.File.path accessible: module java.base 问题

猫头虎 在使用 Java 9 及以上版本时，模块化（Module System）带来的反射限制常会导致如下异常：

Exception in thread "main" java.lang.reflect.InaccessibleObjectException: Unable to make field private final java.lang.String java.io.File.path accessible: module java.base does not “opens java.io” to unnamed module @...

本教程将结合 JDK 8、JDK 11、JDK 17、JDK 21 环境，分步详解该问题的成因及解决方法，帮助你快速上手处理模块化反射访问失败的场景。

一、问题背景与成因

1. Java 模块化（Java Platform Module System, JPMS） 自 JDK 9 起引入模块化，将核心 JDK 拆分为多个模块，并默认封装内部 API，反射访问会被拒绝。
2. 反射访问受限 当第三方库或自定义代码通过反射访问 java.io.File 的私有字段（如 path）时，会因未打开相应包而抛出 InaccessibleObjectException。
3. JDK 8 及以下版本 不存在模块化，不会触发此异常。

二、在不同 JDK 版本下的表现

三、解决思路概览

1. 对 JDK 8：无需额外配置。
2. 对 JDK 9 及以上：通过 JVM 启动参数或模块声明，打开（open）java.base/java.io 包至调用代码所在模块/unnamed module。
   • JVM 参数方式：最便捷、无需修改代码。
   • 模块声明方式：适合自定义模块化项目，用 module-info.java 声明。

四、详细解决方案

1. JDK 8

• 说明：JDK 8 无模块系统，反射访问内部字段不受限。
• 操作：无需任何额外操作，代码可照常运行。

2. JDK 11、JDK 17、JDK 21（统一方案）

对于 JDK ≥ 9，推荐使用 JVM 参数 方式，命令行启动时添加：

# 打开 java.base 模块中的 java.io 包给所有 unnamed module
java --add-opens java.base/java.io=ALL-UNNAMED -jar your-app.jar

2.1 在 IDE（如 IntelliJ IDEA）中配置

打开 Run/Debug Configurations。

在 VM options 中加入：

--add-opens=java.base/java.io=ALL-UNNAMED

保存并运行。

2.2 在 Maven 构建中配置

在 pom.xml 的 <plugin> 配置里，针对 maven-surefire-plugin 和 maven-compiler-plugin 添加：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.0.0-M5</version>
  <configuration>
    <argLine>--add-opens java.base/java.io=ALL-UNNAMED</argLine>
  </configuration>
</plugin>

2.3 在 Gradle 构建中配置

tasks.withType(Test) {
    jvmArgs += "--add-opens=java.base/java.io=ALL-UNNAMED"
}

3. 模块声明方式（高级，可选）

如果你的项目本身采用模块化（即存在 module-info.java），可以在项目模块的声明中添加：

// module-info.java
module your.module.name {
    // 允许本模块使用反射访问 java.io 包
    opens java.io to your.module.name;
    // 其他依赖声明
    requires java.base;
}

⚠️ 注意

• opens 只能对自定义模块生效，对 java.base 这样的 JDK 模块，仍需 JVM 参数 --add-opens。
• opens 形式适用于拆分自身项目模块内各包的进出权限管理，不是针对 JDK 模块的开放。

五、测试验证

以下示例演示了无额外参数和加了 --add-opens 参数时的运行结果对比。

import java.lang.reflect.Field;
import java.io.File;

public class ReflectTest {
    public static void main(String[] args) throws Exception {
        Field pathField = File.class.getDeclaredField("path");
        pathField.setAccessible(true); // 这里会触发 InaccessibleObjectException
        File f = new File("test.txt");
        System.out.println(pathField.get(f));
    }
}

不带参数运行（JDK 11+）

Exception in thread "main" java.lang.reflect.InaccessibleObjectException: Unable to make field private final java.lang.String java.io.File.path accessible: module java.base does not "opens java.io" to unnamed module @...

带参数运行

java --add-opens java.base/java.io=ALL-UNNAMED ReflectTest
# 输出 "test.txt"

六、常见问答

• Q：是否可以使用 --illegal-access=permit？ A：该参数只在 JDK 9～15 默认允许非法访问，JDK 16+ 已移除，不建议依赖。
• Q：为何不修改源码？ A：源码反射依赖 JDK 内部实现，不安全且易失效；使用 JVM 参数或模块声明更稳定。
• Q：如何排查其他类似异常？ A：根据异常提示的模块和包，比如 module java.base does not “opens java.lang”，同理添加 --add-opens java.base/java.lang=ALL-UNNAMED。

七、总结

• JDK 8：无模块，无需处理。
• JDK ≥ 9：模块化引入，反射访问受限。
  • 推荐：--add-opens java.base/java.io=ALL-UNNAMED
  • 高级：在 module-info.java 中使用 opens（仅限自定义模块）。

通过本教程，你已掌握了在不同 JDK 版本下，快速定位并修复 “Unable to make field … accessible” 异常的实战方法。祝你编码顺利，项目无忧！

✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️✍️