spring boot 枚举参数绑定需按场景选择方案：@requestparam/@pathvariable 用 converter 实现字符串到枚举转换；@requestbody 用 jackson 反序列化器（@jsoncreator 或 @jsondeserialize）；配合 @validated 和自定义注解校验非法值；springdoc 自动同步枚举可选值至 api 文档。
Spring Boot 默认支持将请求参数自动绑定为枚举类型，但前提是传入的字符串必须严格匹配枚举常量名（如 MONDAY），而不是自定义的 code 或描述字段（如 "01" 或 "周一"）。直接使用会失败或抛出 MethodArgumentTypeMismatchException。要安全、灵活、可维护地绑定枚举参数，需按场景选择合适方式。
@RequestParam 和 @PathVariable：用 Converter + @Configuration 实现字符串到枚举的双向转换
当枚举值以查询参数（?status=SHIPPED）或路径变量（/order/DELIVERED）形式传入时，Spring 依赖 Converter<string yourenum></string> 完成解析。
- 定义一个实现
Converter<string receiptstatusenum></string>的类，内部调用枚举的fromCode()或fromDesc()静态方法（推荐返回Optional避免 NPE） - 在配置类中注册该 Converter：
@Bean public ConversionService conversionService() { ... }，或更轻量地使用@Configuration @EnableWebMvc+addFormatters(FormatterRegistry) - 控制器中直接写：
@RequestParam ReceiptStatusEnum status，Spring 会自动调用 Converter 解析"0"→ReceiptStatusEnum.OPEN
@RequestBody 中的枚举字段：靠 Jackson 反序列化器控制
JSON 请求体里的枚举字段（如 {"status": "0"}）由 Jackson 处理，不走 Spring 的 Converter 链。
- 在枚举类上加
@JsonCreator(mode = JsonCreator.Mode.DELEGATING)，配合静态工厂方法接收字符串 - 为对应字段添加
@JsonProperty("status")并标注@JsonDeserialize(using = ReceiptStatusDeserializer.class) - 或全局配置 Jackson：
spring.jackson.deserialization.read-unknown-enum-values-as-null=true（防崩溃）+ 自定义SimpleModule注册反序列化器
统一校验与错误提示：结合 @Validated + 自定义约束注解
仅靠类型转换不够——非法值（如 "99"）应明确拒绝并返回友好错误信息。
- 定义注解如
@ValidReceiptStatus，搭配ConstraintValidator<validreceiptstatus string></validreceiptstatus>校验逻辑 - 在 DTO 字段上使用：
@ValidReceiptStatus private String statusStr;，再手动转枚举；或直接校验枚举字段（需确保 Converter 已生效） - 配合全局异常处理器捕获
MethodArgumentNotValidException和HttpMessageNotReadableException，统一输出错误码和提示
文档与前端协作：用 SpringDoc（Swagger）同步枚举可选值
前端需要知道合法参数有哪些，不能靠猜。SpringDoc 可自动提取枚举信息生成 OpenAPI 文档。
- 确保枚举类有
@Schema(description = "...")，字段有@Schema(allowableValues = {"0", "1"}) - 若用 code 字段映射，可在
@Schema中通过example或description注明 “取值：0=待开收据，1=已开收据” - 避免文档和代码脱节——枚举变更时，文档自动更新，无需人工维护
