java 17 对反射机制进行了调整，导致直接修改 `final static` 字段时可能遇到 `nosuchfieldexception`。本文将深入探讨这一变化的原因，并提供一个在 java 17 环境下通过反射安全修改 `final static` 字段的实用工作方案，包括必要的 jvm 启动参数和代码实现细节，帮助开发者克服反射操作的兼容性挑战。
Java 17 反射机制的变更背景
在 Java 11 及更早版本中，通过反射修改类的 private static final 字段是一种常见的操作，通常用于单元测试或框架层面的特殊需求。其核心在于获取 Field 对象的 modifiers 字段，并将其 FINAL 修饰符移除，从而允许修改其值。然而，自 Java 12 起，这一行为发生了变化。OpenJDK 的一个重要更新 (JDK-8210522) 导致 java.lang.reflect.Field 类中的 modifiers 字段不再能直接通过 getDeclaredField("modifiers") 访问。这是为了增强 JVM 的内部封装性，限制对内部实现细节的直接操作，以提高稳定性和安全性。
当尝试在 Java 17 中执行以下代码时，会抛出 NoSuchFieldException: modifiers 错误：
public static void setFinalStatic(Field field, Object newValue) throws Exception {
field.setAccessible(true);
// 这一行在 Java 17 中会抛出 NoSuchFieldException
Field modifiersField = Field.class.getDeclaredField("modifiers");
modifiersField.setAccessible(true);
modifiersField.setInt(field, field.getModifiers() & ~Modifier.FINAL);
field.set(null, newValue);
}尽管尝试添加 --add-opens java.base/java.lang.reflect=ALL-UNNAMED 这样的 JVM 启动参数，也无法解决这个问题，因为问题并非出在模块访问权限，而是 modifiers 字段本身不再是 getDeclaredField 的可直接目标。
Java 17 环境下的解决方案
为了在 Java 17 及更高版本中实现对 final static 字段的反射修改，我们需要采用一种间接的方式来获取 modifiers 字段。这个工作方案利用了 Java 内部的 getDeclaredFields0 方法，它能返回一个类声明的所有字段，包括那些通常无法直接访问的内部字段。
立即学习“Java免费学习笔记（深入）”；
实现代码
以下是适用于 Java 17 的 setFinalStatic 方法实现：
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
public class ReflectionUtil {
/**
* 在 Java 17 及更高版本中，通过反射修改 final static 字段的值。
* 此方法通过内部反射机制获取并修改 Field 对象的 modifiers 字段。
*
* @param field 要修改的 Field 对象。
* @param newValue 字段的新值。
* @throws Exception 如果反射操作失败。
*/
public static void setFinalStatic(Field field, Object newValue) throws Exception {
// 1. 确保字段可访问
field.setAccessible(true);
// 2. 获取 Class 类的 getDeclaredFields0 内部方法
// 这个方法可以返回一个类声明的所有字段，包括内部字段
Method getDeclaredFields0 = Class.class.getDeclaredMethod("getDeclaredFields0", boolean.class);
getDeclaredFields0.setAccessible(true);
// 3. 调用 getDeclaredFields0 方法，获取 Field.class 的所有字段
// 目的是找到 Field 类内部的 "modifiers" 字段
Field[] fields = (Field[]) getDeclaredFields0.invoke(Field.class, false);
// 4. 遍历找到名为 "modifiers" 的 Field 对象
Field modifiersField = null;
for (Field each : fields) {
if ("modifiers".equals(each.getName())) {
modifiersField = each;
break;
}
}
// 5. 确保找到了 modifiers 字段，并使其可访问
if (modifiersField == null) {
throw new NoSuchFieldException("Could not find 'modifiers' field in java.lang.reflect.Field class.");
}
modifiersField.setAccessible(true);
// 6. 移除目标字段的 FINAL 修饰符
// 通过位运算，将 FINAL 位（Modifier.FINAL）从 modifiers 字段中清除
modifiersField.setInt(field, field.getModifiers() & ~Modifier.FINAL);
// 7. 设置目标字段的新值
// 对于 static 字段，第一个参数为 null
field.set(null, newValue);
}
// 示例用法
public static final String MY_CONSTANT = "Original Value";
public static void main(String[] args) throws Exception {
System.out.println("原始值: " + MY_CONSTANT);
Field myConstantField = ReflectionUtil.class.getDeclaredField("MY_CONSTANT");
setFinalStatic(myConstantField, "Modified Value");
System.out.println("修改后的值: " + MY_CONSTANT);
}
}必要的 JVM 启动参数
由于此解决方案涉及到对 java.lang.Class 内部方法的调用以及对 java.lang.reflect.Field 内部字段的修改，为了绕过 Java 模块系统的强封装限制，您需要在运行 JVM 时添加以下 —add-opens 参数：
--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("getDeclaredFields0", boolean.class) 是必需的。
- --add-opens java.base/java.lang.reflect=ALL-UNNAMED: 允许未命名模块的代码通过反射访问 java.base 模块中的 java.lang.reflect 包的私有成员。这对于修改 Field 对象的 modifiers 字段是必需的。
注意事项与总结
- 内部 API 使用风险： 这种解决方案依赖于 Java 内部 API (getDeclaredFields0 方法和 modifiers 字段)。内部 API 不保证在未来的 Java 版本中保持不变。这意味着您的代码在未来的 Java 版本中可能会再次失效。
- 安全性和稳定性： 绕过 final 关键字的语义通常被认为是一种不推荐的做法，因为它可能破坏程序的预期行为和安全性。除非有非常明确且充分的理由（如特殊的测试场景或框架级别的底层操作），否则应避免修改 final 字段。
- 替代方案： 在可能的情况下，优先考虑使用更标准的、非反射的编程实践。如果需要可变配置，请不要将其声明为 final。
- 模块化考量： Java 模块系统（Jigsaw）旨在加强封装。使用 —add-opens 参数本质上是在削弱这种封装。理解其含义并谨慎使用。
尽管存在上述风险，但对于那些需要在 Java 17 环境下继续执行 final static 字段反射修改的特定场景，本文提供的方案是一个有效的技术性工作。开发者应充分理解其原理和潜在影响，并权衡利弊后审慎采用。
