SpringBoot 1.5升级2.0时PostgreSQL枚举类型异常问题

嘿，我之前也踩过Spring Boot版本迁移时枚举映射的坑，从你贴的日志来看，问题根源很清晰：Hibernate在绑定数据库参数时用了OPTIONA这个不完整的枚举值，而不管是你的Java枚举类还是数据库的枚举列定义，都不认可这个值，所以触发了保存异常。下面是一步步的排查和解决思路：

1. 先核对枚举类的定义与拼写 #

首先检查你的Java枚举类，看看是不是存在拼写错误：

• 有没有把OPTION_A（或者其他正确的枚举常量名）误写成了OPTIONA？
• 如果你的枚举类自定义了toString()方法或者用@JsonValue指定了序列化值，确认这些方法返回的字符串是正确的枚举值，而不是截断/错误的内容。

举个反例，比如下面的枚举就会导致问题：

public enum MyOptionEnum {
    OPTION_A("OPTIONA"), // 这里构造函数的字符串少了下划线，会导致序列化后变成OPTIONA
    OPTION_B("OPTIONB");

    private String code;

    MyOptionEnum(String code) {
        this.code = code;
    }

    @JsonValue // 这个注解会让Spring用code值来序列化枚举
    public String getCode() {
        return code;
    }
}

2. 确认Hibernate枚举映射策略的变化 #

Spring Boot 2.0默认集成的Hibernate版本是5.2+，而Spring Boot 1.5用的是Hibernate 5.0/5.1，两者的枚举默认映射策略可能有差异：

• Spring Boot 1.5中，Hibernate默认对枚举的映射可能是EnumType.ORDINAL（按枚举的序号存数字）
• Spring Boot 2.0中，部分场景下默认会切换为EnumType.STRING（按枚举的名称存字符串）

解决方法是在实体类的枚举字段上显式指定映射策略，和你1.5版本的配置保持一致：

import javax.persistence.Enumerated;
import javax.persistence.EnumType;
import javax.persistence.Column;

// ...
@Column(name = "enum_column")
@Enumerated(EnumType.STRING) // 或者EnumType.ORDINAL，根据你1.5时的实际配置选择
private MyOptionEnum enumColumn;

3. 检查数据库枚举列的定义 #

如果你的数据库用的是原生枚举类型（比如PostgreSQL的ENUM、MySQL的ENUM），需要确认：

• 数据库中的枚举值列表是否包含OPTIONA？如果不包含，要么修正Java枚举的序列化值，要么更新数据库的枚举类型定义，让两者保持一致。
• 如果你是从1.5迁移过来，之前数据库存的是枚举序号（数字），现在改成存字符串，需要做数据迁移，或者保持映射策略为ORDINAL。

4. 排查Spring数据绑定的问题 #

如果上面的步骤都没问题，那可能是Spring Boot 2.0的数据绑定规则变化导致的：

• 在保存实体前，手动打印一下要保存的实体的枚举字段值，确认它是不是真的被错误地设置成了OPTIONA
• 检查有没有自定义的枚举Converter，在Spring Boot 2.0中是否被正确注册（比如Converter<String, MyOptionEnum>），有没有在转换时出现逻辑错误。

内容的提问来源于stack exchange，提问作者Joel