必须用name()。因name()不可重写、值稳定且跨版本一致，而toString()可被重写，用于持久化会导致反序列化失败、数据错位及隐性崩溃风险。
持久化时该用 name() 还是 toString()？
必须用 name()。任何把 toString() 结果存进数据库、JSON 或配置文件的方案，都存在隐性崩溃风险。
为什么 toString() 不适合持久化
toString() 是可重写的，而持久化要求值稳定、可逆、跨版本一致。一旦业务方某天给枚举加了中文描述或拼写调整，所有依赖 toString() 反序列化的逻辑就会失效。
- 反序列化 JSON 时，
Enum.valueOf(MyEnum.class, jsonValue)只认name()对应的原始标识符，不认toString()返回值 - MyBatis / JPA 默认也基于
name()映射（除非显式配置@Enumerated(EnumType.STRING)并配合自定义转换器） - 日志中记录
toString()看起来友好，但若后续用它做条件查询或状态判断，等于把显示逻辑混进了数据契约
什么场景下 name() 可能也不够用
当枚举常量名本身不满足业务语义约束时，比如 USER_ACTIVE 存库没问题，但前端要显示“启用”，导出 Excel 要写“已激活”，这时不能靠 toString() 混用，而应引入专用字段。
- 添加私有字段（如
label、code），在构造器中初始化 - 提供不可变的 getter，例如
getLabel()供 UI 层调用，getCode()供外部系统对接 - 避免在枚举里塞逻辑方法（如
isDeprecated()），复杂状态建议抽离为独立服务或策略类
一个典型错误：用 toString() 做 MyBatis 枚举映射
默认 @Enumerated(EnumType.STRING) 会调用 name()；如果手动覆盖了 toString()，又没配 org.apache.ibatis.type.EnumTypeHandler 的子类，就可能出现“查出来是‘春季’，但数据库存的是‘SPRING’”这种错位。
- 检查你的
mybatis-config.xml或@Configuration类里是否注册了自定义TypeHandler - 若需存中文，明确用
@Enumerated(EnumType.ORDINAL)+ 自定义转换器，或直接用int字段 +Map查表 - 单元测试里务必验证：从 DB 读出 → 转枚举 → 再转字符串，是否与原始入库值一致
最易被忽略的一点：团队里有人在枚举里重写 toString() 时，往往不会同步更新文档、测试用例和上下游接口契约——这比技术选型错误更难排查。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
