Spring Boot适配Oracle序列生成String类型主键问题求助

这个报错的核心原因是Hibernate默认的序列生成器只支持数值类型（如Long、Integer）的主键，当你的主键是String类型时，它不知道如何将序列返回的数值转换为字符串，所以抛出了IdentifierGenerationException。既然不能修改表结构，这里提供两种无需改表的可行方案：

方案一：自定义Hibernate标识符生成器 #

这种方式通过实现Hibernate的IdentifierGenerator接口，手动处理序列值到String的转换，完全贴合Hibernate的主键生成机制。

步骤1：编写自定义生成器类 #

创建一个实现IdentifierGenerator的类，在generate方法中调用Oracle序列并将结果转为String：

import org.hibernate.engine.spi.SharedSessionContractImplementor;
import org.hibernate.id.IdentifierGenerator;
import java.io.Serializable;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;

public class StringSequenceGenerator implements IdentifierGenerator {

    @Override
    public Serializable generate(SharedSessionContractImplementor session, Object object) {
        try (Connection connection = session.connection();
             PreparedStatement ps = connection.prepareStatement("SELECT SCHEMA.TABLE_SEQ.NEXTVAL FROM DUAL")) {
            
            ResultSet rs = ps.executeQuery();
            if (rs.next()) {
                Long sequenceValue = rs.getLong(1);
                return sequenceValue.toString(); // 将数值序列转为String
            }
        } catch (Exception e) {
            throw new RuntimeException("Failed to generate String ID from sequence", e);
        }
        throw new RuntimeException("Could not retrieve sequence value for ID generation");
    }
}

步骤2：修改实体类的主键注解 #

将原有的@SequenceGenerator和@GeneratedValue替换为@GenericGenerator，指定自定义生成器的全类名：

import jakarta.persistence.*;

@Entity
@Table(name = "TABLE", schema = "SCHEMA")
public class Table {
    @Id
    @GenericGenerator(
        name = "SCROLL_ID_GENERATOR",
        strategy = "com.yourproject.package.StringSequenceGenerator" // 替换为你的类实际路径
    )
    @GeneratedValue(generator = "SCROLL_ID_GENERATOR")
    @Column(name = "SCROLL_NO")
    private String id;

    @Column(name = "MOBILE")
    private String mobile;
    @Column(name = "AMOUNT")
    private Double amount;

    // Getters and Setters
}

方案二：使用@PrePersist注解手动生成主键 #

如果不想额外编写生成器类，这种方式更简洁，在实体保存前手动调用序列赋值给主键。

修改实体类代码 #

注入EntityManager，并添加@PrePersist注解的方法，在实体持久化前生成String类型主键：

import jakarta.persistence.*;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

@Entity
@Table(name = "TABLE", schema = "SCHEMA")
@EntityListeners(AuditingEntityListener.class)
public class Table {
    @Id
    @Column(name = "SCROLL_NO")
    private String id;

    @Column(name = "MOBILE")
    private String mobile;
    @Column(name = "AMOUNT")
    private Double amount;

    @PersistenceContext
    private transient EntityManager entityManager;

    @PrePersist
    public void generateScrollNo() {
        if (id == null) {
            // 调用Oracle序列获取下一个值
            Query query = entityManager.createNativeQuery("SELECT SCHEMA.TABLE_SEQ.NEXTVAL FROM DUAL");
            Long sequenceValue = (Long) query.getSingleResult();
            this.id = sequenceValue.toString();
        }
    }

    // Getters and Setters
}

两种方案的对比 #

• 自定义生成器：更符合Hibernate的底层机制，适合多个实体需要相同String主键生成逻辑的场景，代码可复用性高。
• @PrePersist方式：实现简单，代码集中在实体类内部，适合单个实体的快速解决场景。

注意事项 #

1. 确保应用程序使用的数据库用户拥有SCHEMA.TABLE_SEQ序列的SELECT权限，否则会抛出权限异常。
2. 如果你使用的是Spring Boot 3.x版本，注意JPA相关注解来自jakarta.persistence包，而非旧版的javax.persistence。
3. 确认序列生成的数值长度不超过SCROLL_NO字段的VARCHAR2(20)限制（当前序列的MAXVALUE是28位数字，实际使用中要注意避免超出字段长度）。

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