反射配合注解实现运行时动态行为，需明确注解保留策略（@Retention(RUNTIME)）和作用目标（@Target(FIELD)），通过反射扫描字段、提取注解配置并安全注入值，适用于灰度发布、AB测试等场景。
反射配合注解，是实现运行时动态行为的核心组合——不是为了炫技，而是让代码能根据元数据自动调整逻辑。关键不在“能不能做”，而在于“什么时候该做、怎么做才稳”。
明确注解的保留策略和作用目标
注解本身不执行任何操作，它只是标记。若想在运行时读取，必须声明 @Retention(RetentionPolicy.RUNTIME)；若要标注字段并后续修改其值，还需加上 @Target(ElementType.FIELD)。
例如定义一个用于标识需动态赋值的字段：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface DynamicValue {
String source() default "config"; // 指定值来源：config / env / mock
String key() default ""; // 配置项键名
}
这样写之后，字段上加 @DynamicValue(source = "env", key = "user.timeout")，就具备了被反射识别和处理的前提。
用反射扫描字段并提取注解配置
拿到目标对象后，通过 getClass().getDeclaredFields() 获取全部字段（含 private），再逐个检查是否带 @DynamicValue 注解：
- 调用
field.setAccessible(true)绕过访问控制 - 用
field.getAnnotation(DynamicValue.class)提取配置参数 - 根据
source字段决定从哪读值：环境变量、配置中心、硬编码模拟值等 - 注意类型匹配：String 直接赋值，int/Integer 需 parse，Boolean 要转义
注入逻辑需兼顾安全与可维护性
直接暴力设值容易出错，建议封装成可复用的工具方法，并加入基础防护：
- 捕获
NoSuchFieldException和IllegalAccessException，避免因字段不存在或权限问题导致整个流程中断 - 对基本类型和包装类做兼容处理（如 int 字段允许注入 Integer 值）
- 支持默认值 fallback：当配置未命中时，不抛异常，而是设为预设默认值
- 避免在高频路径（如请求处理循环内）反复反射——可提前缓存 Field 对象或构建注入器单例
典型业务场景示例
比如订单服务中某字段需按环境动态生效：
class OrderProcessor {
@DynamicValue(source = "config", key = "order.retry.count")
private int maxRetryTimes = 3;
@DynamicValue(source = "env", key = "ORDER_TIMEOUT_MS")
private long timeoutMs = 5000L;
}
启动时调用 Injector.inject(orderProcessor)，就能把配置中心里的 order.retry.count=5 和系统环境变量 ORDER_TIMEOUT_MS=8000 自动写入对应字段，无需改代码、不依赖 Spring 容器。
这种模式在灰度发布、AB 测试、多租户差异化配置等场景中非常实用。
