Java枚举与前端双向绑定的核心是统一序列化/反序列化规则并确保三端语义一致；应优先使用字符串映射（如"PENDING"），避免ordinal()；需通过@JsonValue/@JsonCreator（Jackson）或@JSONConstructor（Fastjson2）等显式控制，且前后端命名、码值须严格契约化。
Java枚举与前端（如 JSON 字符串或数字）的双向绑定，核心在于统一序列化/反序列化规则，并确保各层（Java、JSON 库、前端框架）理解同一语义。主流对象映射工具（Jackson、Fastjson2、Gson）均可实现，但配置方式和细节差异明显。关键不是“选哪个”，而是“如何让三端对枚举值达成共识”。
明确枚举的绑定语义：字符串优先，数字谨慎
前端习惯用可读字符串（如 "PENDING"、"active"），而非序号（0、1）。除非业务强约束（如协议要求紧凑二进制传输），否则应默认以字符串形式双向映射。若必须支持数字，需显式定义码值（如 code 字段），避免依赖 ordinal() —— 它易因枚举顺序变更而断裂。
- 在枚举中定义稳定字段，例如：
public final int code;和public final String desc; - 避免直接暴露
name()或ordinal()给外部；用toString()或自定义 getter 控制输出 - 前端传
{"status": "DRAFT"}或{"status": 2}都应能正确反序列化为对应枚举实例
Jackson：用 @JsonValue + @JsonCreator 实现精准控制
Jackson 是 Spring Boot 默认 JSON 库，推荐通过注解声明式定义绑定逻辑，无需全局配置干扰其他类型。
- 在枚举中用
@JsonValue标记返回前端的字段（通常为字符串） - 用
@JsonCreator标记静态工厂方法，接收 JSON 值（String 或 Integer），查找并返回对应枚举 - 示例：若支持字符串和数字两种输入，工厂方法内先尝试 parse int，再 fallback 到 name 匹配
- 禁用
WRITE_ENUMS_USING_TO_STRING等全局设置，防止覆盖枚举自身语义
Fastjson2：靠 ParserConfig + 枚举构造器，兼顾兼容与性能
Fastjson2（v2.0+）默认不识别 Jackson 注解，需主动注册解析策略。推荐为枚举单独注册 ObjectDeserializer，或利用其支持构造器参数的特性。
立即学习“Java免费学习笔记（深入）”；
- 枚举提供含
String或int参数的私有构造器，并标注@JSONConstructor - 配合
ParserConfig.getGlobalInstance().putDeserializer(YourEnum.class, ...)注册自定义反序列化器 - 序列化时重写
toString()并启用WriteEnumUsingToString，或使用@JSONField(serializeUsing = ...) - 注意：Fastjson2 对
ordinal()无默认支持，必须显式编码
前端配合：保持命名一致，避免大小写陷阱
绑定失效常因大小写不匹配（如 Java 枚举名 PUBLISHED，前端传 "published"）。不能只靠后端“智能转换”，而应约定规范并前置校验。
- 后端枚举字段建议用
UPPER_CASE，前端 API 文档明确标注可选值（如status: "DRAFT" | "PUBLISHED" | "ARCHIVED"） - 若需小写兼容，可在
@JsonCreator工厂方法中统一转大写再匹配，或使用Enum.valueOf(String)前调用toUpperCase() - 前端提交前做简单校验（如用 TypeScript enum 或 schema 校验），比后端兜底更可靠
- 数字绑定时，前后端共用同一码表文档，禁止前端硬编码 magic number
不复杂但容易忽略：三方无缝的关键不在工具本身，而在是否把枚举当作“契约实体”来设计——它不是 Java 内部状态，而是跨语言接口的一部分。
