深入解析Java 17中反射修改私有静态Final字段的挑战与解决方案-java教程-PHP中文网

深入解析Java 17中反射修改私有静态Final字段的挑战与解决方案

碧海醫心

发布： 2025-11-23 17:26:02

原创

455人浏览过

深入解析Java 17中反射修改私有静态Final字段的挑战与解决方案

java 17对内部api的封装性进行了增强，导致传统反射方式修改`final static`字段时会遇到`nosuchfieldexception`。本文详细阐述了该问题的原因，并提供了一种在java 17环境下通过更深层次的反射机制访问内部`modifiers`字段的解决方案，同时强调了必要的jvm启动参数配置及反射操作的注意事项。

引言

Java反射机制为开发者提供了在运行时检查和修改类、方法、字段的能力。这在某些特定场景下非常有用，例如框架开发、单元测试中模拟私有状态等。然而，随着Java平台模块化系统（Jigsaw项目）的引入和对内部API封装的加强，尤其是从Java 9开始，以及在后续版本如Java 17中的持续演进，直接通过反射访问和修改内部字段变得越来越困难。本文将聚焦于Java 17环境下，修改私有静态final字段时遇到的挑战及其解决方案。

Java 11及之前版本的反射修改方法

在Java 11及更早的版本中，修改一个类的私有静态final字段通常涉及以下步骤：

获取目标字段的Field对象。
设置该Field对象为可访问（setAccessible(true)）。
通过反射获取Field类自身的modifiers字段，该字段存储了目标字段的修饰符信息。
将modifiers字段设为可访问，然后通过位运算移除FINAL修饰符。
最后，使用field.set(null, newValue)来修改静态字段的值。

以下是Java 11环境下可用的示例代码：

import java.lang.reflect.Field;
import java.lang.reflect.Modifier;

public class ReflectionModifierJava11 {

    private static final String MY_CONSTANT = "Original Value";

    public static void setFinalStatic(Field field, Object newValue) throws Exception {
        field.setAccessible(true);
        // 获取Field类自身的modifiers字段
        Field modifiersField = Field.class.getDeclaredField("modifiers");
        modifiersField.setAccessible(true);
        // 移除FINAL修饰符
        modifiersField.setInt(field, field.getModifiers() & ~Modifier.FINAL);
        // 设置新值
        field.set(null, newValue);
    }

    public static void main(String[] args) throws Exception {
        System.out.println("Before modification: " + MY_CONSTANT);
        Field field = ReflectionModifierJava11.class.getDeclaredField("MY_CONSTANT");
        setFinalStatic(field, "Modified Value Java 11");
        System.out.println("After modification: " + MY_CONSTANT);
    }
}

登录后复制

这段代码在Java 11中能够正常运行，并成功修改MY_CONSTANT的值。

立即学习“Java免费学习笔记（深入）”；

Java 17中遇到的挑战

当尝试将上述代码在Java 17环境中运行时，会遇到java.lang.NoSuchFieldException: modifiers异常，具体堆栈信息如下：

java.lang.NoSuchFieldException: modifiers
    at java.base/java.lang.Class.getDeclaredField(Class.java:2610)
    // ...

登录后复制

即使尝试添加JVM参数--add-opens java.base/java.lang.reflect=ALL-UNNAMED，也无法解决此问题。

原因分析：

Looka

AI辅助Logo和品牌设计工具

894

查看详情

从Java 12开始，OpenJDK针对内部API的封装性进行了进一步加强。具体来说，java.lang.reflect.Field类中的modifiers字段不再是一个可以直接通过getDeclaredField("modifiers")访问的字段。这一变化是出于平台安全性和内部实现稳定性的考虑，旨在阻止开发者过度依赖和篡改Java运行时内部结构。相关的OpenJDL issue JDK-8210522 指出了这一变化。简而言之，modifiers字段在内部的表示方式发生了变化，或者其访问权限被收紧，导致传统的反射方法失效。

Java 17的解决方案与工作原理

为了在Java 17中实现对final static字段的修改，我们需要采用一种更为底层的反射方法来获取modifiers字段。解决方案的核心是利用Class类的一个内部方法getDeclaredFields0来获取所有声明的字段，然后从中筛选出名为"modifiers"的字段。

以下是Java 17环境下可用的解决方案代码：

import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;

public class ReflectionModifierJava17 {

    private static final String MY_CONSTANT = "Original Value Java 17";

    public static void setFinalStatic(Field field, Object newValue) throws Exception {
        field.setAccessible(true);

        // 通过反射获取Class类中的getDeclaredFields0方法
        Method getDeclaredFields0 = Class.class.getDeclaredMethod("getDeclaredFields0", boolean.class);
        getDeclaredFields0.setAccessible(true);

        // 调用getDeclaredFields0方法获取Field类中所有声明的字段
        Field[] fields = (Field[]) getDeclaredFields0.invoke(Field.class, false);

        Field modifiersField = null;
        // 遍历找到名为"modifiers"的字段
        for (Field each : fields) {
            if ("modifiers".equals(each.getName())) {
                modifiersField = each;
                break;
            }
        }

        if (modifiersField == null) {
            throw new NoSuchFieldException("modifiers field not found in Field.class");
        }

        modifiersField.setAccessible(true);
        modifiersField.setInt(field, field.getModifiers() & ~Modifier.FINAL);
        field.set(null, newValue);
    }

    public static void main(String[] args) throws Exception {
        System.out.println("Before modification: " + MY_CONSTANT);
        Field field = ReflectionModifierJava17.class.getDeclaredField("MY_CONSTANT");
        setFinalStatic(field, "Modified Value Java 17");
        System.out.println("After modification: " + MY_CONSTANT);
    }
}

登录后复制

工作原理：

获取getDeclaredFields0方法： 我们不再直接调用Field.class.getDeclaredField("modifiers")。取而代之的是，通过Class.class.getDeclaredMethod("getDeclaredFields0", boolean.class)来获取Class类的一个内部方法getDeclaredFields0。这个方法是Java内部用来获取一个类所有声明字段的底层机制。
设置可访问性： 获取到getDeclaredFields0方法后，同样需要调用getDeclaredFields0.setAccessible(true)来允许对其进行访问。
调用getDeclaredFields0： 使用getDeclaredFields0.invoke(Field.class, false)来调用该方法，传入Field.class作为目标对象，false表示不获取公共字段。这将返回一个Field[]数组，其中包含了Field类内部所有的字段（包括那些不可直接通过getDeclaredField访问的）。
遍历查找modifiers： 遍历这个Field[]数组，通过each.getName()找到名称为"modifiers"的字段。
后续操作： 一旦找到modifiersField，后续的步骤与Java 11版本相同：将其设为可访问，然后通过位运算修改目标字段的修饰符，最后设置新值。

运行环境配置

要在Java 17环境中成功运行上述解决方案，必须添加特定的JVM启动参数，以开放对Java内部模块的反射访问权限。这是因为java.lang.reflect.Field类位于java.base模块中，而我们试图访问其内部结构。

所需的JVM参数如下：

--add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.lang.reflect=ALL-UNNAMED

登录后复制

--add-opens java.base/java.lang=ALL-UNNAMED: 允许所有未命名模块的代码通过反射访问java.base模块中的java.lang包。这对于我们获取Class.class.getDeclaredMethod等操作至关重要。
--add-opens java.base/java.lang.reflect=ALL-UNNAMED: 允许所有未命名模块的代码通过反射访问java.base模块中的java.lang.reflect包。这确保了我们可以访问Field类及其内部字段，包括通过getDeclaredFields0方法获取到的modifiers字段。

缺少这些参数中的任何一个，都可能导致在运行时遇到InaccessibleObjectException或类似错误。