应使用@EnumDesc注解标注枚举常量并配合反射工具类统一读取描述，首次加载时缓存“常量→描述”映射，再通过Jackson自定义序列化器或@JsonValue集成到响应中，避免硬编码和侵入业务。
要让枚举值在响应中自动显示中文描述，而不是原始枚举名，关键不是硬编码每个枚举的toString()或getDesc()，而是用注解声明描述，再靠反射统一读取——这样新增枚举无需改工具类，也不用侵入业务代码。
定义描述注解
创建一个运行时保留、可标注在枚举常量上的注解，用于携带展示文本：
- @EnumDesc：标注在枚举常量上，value 为要显示的中文描述
- 必须用
@Target(ElementType.CONSTANT)，确保只能写在枚举值上 - 加上
@Retention(RetentionPolicy.RUNTIME)，反射才能读到
反射读取描述的通用方法
写一个静态工具方法，输入任意枚举常量，返回其@EnumDesc的 value；若未标注，则回退为枚举名：
- 通过
enumConstant.getDeclaringClass()获取所属枚举类 - 调用
enumConstant.getClass().getDeclaredFields()不适用——字段不可见；应直接用enumConstant.getClass().getAnnotation(EnumDesc.class)？错，注解在常量上，不是类上 - 正确方式：用
enumConstant.getClass().getDeclaredMethod("values")获取所有常量，遍历比对 ==，再对匹配项调用getAnnotationsByType(EnumDesc.class) - 更高效做法：缓存每个枚举类的「常量→描述」映射，首次加载时反射扫描一次，后续直接查 Map
集成到统一响应体
在 Spring Boot 的 @ControllerAdvice 或自定义序列化器（如 Jackson 的 SimpleModule）中注入该逻辑：
- 当响应对象含枚举字段时，不直接序列化 enum.name()，而是调用上述工具方法获取描述
- 配合
@JsonSerialize自定义序列化器，让所有枚举类型默认走描述逻辑 - 若用 Lombok，可配合
@JsonValue注解在枚举中统一加一个 getter，内部调用反射工具
避免常见陷阱
反射读枚举描述看似简单，但容易踩坑：
- 不要在枚举构造器里调用反射——类加载阶段可能未就绪
- 注意枚举类被代理（如 AOP 增强）后，
getClass()返回的是 CGLIB 类，需用getSuperclass()回溯 - 多模块项目中，确保注解类和工具类在相同类加载器下，否则
instanceof或反射查找会失败 - 单元测试时，若用
Mockito.mock()枚举，反射将失效——应直接用真实枚举实例测试
