Hibernate中使用Oracle序列生成String类型主键的问题

这个问题我之前也碰到过——Oracle序列返回的是数值类型，而你的主键定义为String，Hibernate没法直接完成隐式类型转换，自然会抛出类型不匹配的异常。给你几个靠谱的解决方案，按需选择：

方案1：使用属性转换器（AttributeConverter） #

这是最简洁的处理方式，通过Hibernate的属性转换器自动把序列生成的Long值转成String：

首先创建转换器类：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;

@Converter(autoApply = false) // 仅在指定字段生效，不全局自动应用
public class LongToStringConverter implements AttributeConverter<Long, String> {

    @Override
    public String convertToDatabaseColumn(Long attribute) {
        return attribute != null ? attribute.toString() : null;
    }

    @Override
    public Long convertToEntityAttribute(String dbData) {
        return dbData != null ? Long.parseLong(dbData) : null;
    }
}

然后修改实体类，在主键字段上添加@Convert注解：

@Entity
@Table(name="HEALTH_MST_CHILD")
public class HealthMstChild {
    @Id
    @SequenceGenerator(name="childHealthSeq", sequenceName="HEALTH_MST_CHILD_SEQ", allocationSize=1)
    @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="childHealthSeq")
    @Column(name="CHILD_ID")
    @Convert(converter = LongToStringConverter.class) // 绑定转换器
    private String childId;

    // 其他字段、getter/setter...
}

这个方案代码侵入性低，逻辑清晰，适合不需要对序列值做额外格式化的场景。

方案2：自定义序列ID生成器 #

如果需要对序列值做自定义处理（比如添加前缀如CHILD_123），可以自定义ID生成器：

先创建自定义生成器类：

import org.hibernate.id.enhanced.SequenceStyleGenerator;
import org.hibernate.engine.spi.SharedSessionContractImplementor;
import java.io.Serializable;

public class StringSequenceGenerator extends SequenceStyleGenerator {

    @Override
    public Serializable generate(SharedSessionContractImplementor session, Object object) {
        // 调用父类生成Long类型的序列值
        Long sequenceValue = (Long) super.generate(session, object);
        // 转成String返回，这里可按需添加前缀/后缀
        return sequenceValue.toString();
    }
}

然后修改实体类的主键注解，指定自定义生成器：

@Entity
@Table(name="HEALTH_MST_CHILD")
public class HealthMstChild {
    @Id
    @GenericGenerator(
        name = "childHealthSeq",
        strategy = "com.yourpackage.StringSequenceGenerator", // 替换为你的类全路径
        parameters = {
            @Parameter(name = "sequence_name", value = "HEALTH_MST_CHILD_SEQ"),
            @Parameter(name = "allocation_size", value = "1")
        }
    )
    @GeneratedValue(generator = "childHealthSeq")
    @Column(name="CHILD_ID")
    private String childId;

    // 其他字段、getter/setter...
}

这种方式扩展性更强，适合需要对序列值做个性化处理的场景。

方案3：修改主键类型（最简单但需评估业务影响） #

如果业务允许，直接把childId的类型改成Long是最直接的解决方式，彻底避免类型转换问题：

@Entity
@Table(name="HEALTH_MST_CHILD")
public class HealthMstChild {
    @Id
    @SequenceGenerator(name="childHealthSeq",sequenceName="HEALTH_MST_CHILD_SEQ",allocationSize=1)
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="childHealthSeq")
    @Column(name="CHILD_ID")
    private Long childId; // 改为Long类型

    // 其他字段、getter/setter...
}

注意要确认数据库表的CHILD_ID字段是NUMBER类型（和Oracle序列匹配），同时检查业务代码中所有用到childId的地方是否需要同步调整类型，避免连锁问题。

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