Java 17下使用反射修改运行时注解值的问题排查

问题根源 #

Java 9及以后版本引入的模块系统对非法反射访问做了严格限制，且JDK内部用于存储注解的API（如Class.annotationData()方法、内部类的annotations字段）属于未公开的实现细节，在Java 17中这些API的访问权限进一步收紧。同时你原有代码存在逻辑错误——误将Method实例当作annotationData对象来操作，导致无法修改注解映射。

临时解决方案：启用非法反射访问（不推荐用于生产） #

如果必须通过反射修改注解，需要添加VM参数解除模块访问限制，同时修正代码逻辑：

1. 添加VM启动参数：

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

2. 修正后的代码：

   import java.lang.annotation.Annotation;
   import java.lang.reflect.Field;
   import java.lang.reflect.InvocationTargetException;
   import java.lang.reflect.Method;
   import java.util.Map;
   
   public static void changeAnnotationValue(String value) {
       Greeter oldAnnotation = Greetings.class.getAnnotation(Greeter.class);
       Greeter newAnnotation = new Greeter() {
           @Override
           public Class<? extends Annotation> annotationType() {
               return oldAnnotation.annotationType();
           }
   
           @Override
           public String value() {
               return value;
           }
       };
       try {
           // 获取Class类的annotationData方法
           Method annotationDataMethod = Class.class.getDeclaredMethod("annotationData");
           annotationDataMethod.setAccessible(true);
           // 调用方法获取annotationData实例
           Object annotationData = annotationDataMethod.invoke(Greetings.class);
   
           // 获取annotationData中的annotations字段
           Field annotationsField = annotationData.getClass().getDeclaredField("annotations");
           annotationsField.setAccessible(true);
           @SuppressWarnings("unchecked")
           Map<Class<? extends Annotation>, Annotation> annotationsMap = 
               (Map<Class<? extends Annotation>, Annotation>) annotationsField.get(annotationData);
   
           // 替换原有注解
           annotationsMap.put(Greeter.class, newAnnotation);
       } catch (NoSuchMethodException | IllegalAccessException | NoSuchFieldException | InvocationTargetException e) {
           e.printStackTrace();
       }
   }
   

推荐方案：模拟可变注解行为（合规且稳定） #

注解在设计上是不可变的，直接修改JDK内部存储结构属于依赖未公开API，版本兼容性极差。推荐通过包装类封装注解值的获取逻辑，实现类似可变的效果：

public class GreeterAnnotationWrapper {
    private static String customValue;

    // 获取注解值，优先使用自定义值
    public static String getValue() {
        if (customValue != null) {
            return customValue;
        }
        Greeter annotation = Greetings.class.getAnnotation(Greeter.class);
        return annotation != null ? annotation.value() : "";
    }

    // 设置自定义注解值
    public static void setValue(String value) {
        customValue = value;
    }
}

后续业务代码中，通过GreeterAnnotationWrapper.getValue()替代直接调用Greetings.class.getAnnotation(Greeter.class).value()即可。

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