获取类中@NotNull注解字段名，解决500错误与非法反射访问告警

算力阿峰

2026-11-3

根因定位

控制台的非法反射警告直接来自Jackson序列化组件，并非业务代码的反射逻辑触发：接口返回getValue()的结果后，Jackson需要把返回值序列化为JSON格式。由于方法返回的是java.lang.reflect.Field类型数组，序列化过程需要读取Field类的内部私有成员，在JDK9及以上的模块化类加载机制下，跨模块访问JDK内部类的私有成员属于非法反射操作，轻则打印警告，重则直接抛出InaccessibleObjectException，最终表现为接口返回500错误。
核心业务逻辑漏写：开发目标是获取类中所有携带@NotNull注解的字段名称，但当前getValue()方法仅完成了带注解字段的筛选，直接把Field对象数组返回，完全没有执行提取字段名的映射操作。
反射权限未处理：业务代码遍历类的私有字段时没有显式设置访问权限，在高版本JDK的严格模块封装下，哪怕只是读取字段上的注解，也可能触发访问限制。

排查思路

不要把控制台警告直接等同于报错根因：顺着500错误对应的服务端堆栈日志，定位真正抛出异常的节点，这类问题的根因通常是Jackson序列化Field对象时触发的InaccessibleObjectException，警告只是前置提示。
断点校验返回值类型：在getValue()方法的返回行打断点，检查返回数组内的元素实际类型，确认是否为Field对象而非预期的字段名字符串。
核对运行环境JDK版本：JDK8及之前的版本没有模块化封装限制，不会触发这类非法反射警告，只有JDK9及以上默认开启严格模块封装的环境才会出现该类问题。

修复方案

优先修正核心业务逻辑，从根源避免序列化Field对象的问题：把原方法的返回值从Object[]调整为字符串数组，筛选到带@NotNull注解的Field后，直接提取字段名称返回，不要把反射对象作为接口返回值。修正后的参考代码：

public boolean hasNotNull() {
    return Arrays.stream(this.getClass().getDeclaredFields())
            .anyMatch(field -> field.isAnnotationPresent(NotNull.class));
}

public String[] getNotNullFieldNames() {
    if (!hasNotNull()) {
        return new String[0];
    }
    return Arrays.stream(this.getClass().getDeclaredFields())
            .filter(field -> field.isAnnotationPresent(NotNull.class))
            // 映射为字段名称字符串，避免返回Field对象触发序列化问题
            .map(Field::getName)
            .toArray(String[]::new);
}

代码细节优化：
- 替换原逻辑中“无匹配字段返回null”的写法，空结果返回空数组，减少后续业务调用、序列化阶段的空指针风险。
- 遍历字段时显式调用field.setAccessible(true)，规避高版本JDK对私有字段访问的权限拦截，哪怕只是读取字段上的注解元信息，也能降低访问限制触发概率。
如果业务确实需要通过反射读取字段值，不要把Field对象直接暴露给序列化流程：在服务层完成字段值的提取，把普通Java Bean作为接口返回值交给Jackson处理，从根本上避免Jackson访问JDK反射类的内部私有成员。
本地调试临时绕过方案：如果需要临时复现旧版本JDK的反射宽松环境，可以在JVM启动参数中添加--add-opens java.base/java.lang.reflect=ALL-UNNAMED开放反射类的访问权限，但不建议在生产环境长期使用这类绕过配置——高版本JDK后续会直接禁止所有未授权的非法反射操作，这类配置的兼容寿命有限。

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