使用Quarkus+Panache+Hibernate 6预加载IDENTITY表及关联表的问题

一、解决IDENTITY_INSERT开启后仍报错的问题 #

出现该错误通常有两个核心原因，对应解决方法如下：

1. 未显式指定插入列列表
   SQL Server要求开启IDENTITY_INSERT后，插入语句必须显式列出所有要插入的列（包括标识列），不能省略列名直接使用INSERT INTO BUSINESS_UNITS VALUES(...)。正确写法示例：

   SET IDENTITY_INSERT BUSINESS_UNITS ON;
   INSERT INTO BUSINESS_UNITS (id, name, description, created_date) 
   VALUES (1, '总部', '公司总部', GETDATE());
   SET IDENTITY_INSERT BUSINESS_UNITS OFF;
   

2. 会话作用域失效
   IDENTITY_INSERT是会话级设置，同一时间仅能对一个表开启。如果import.sql中穿插了其他表的操作，或语句被拆分为多个会话执行，会导致设置失效。确保针对目标表的开启、插入、关闭操作连续执行，中间不要插入无关SQL。

二、预加载时获取生成的ID插入关联表 #

根据需求场景，提供三种可行方案：

方案1：固定标识列值（适合需预设ID的场景） #

若可提前确定BUSINESS_UNITS的ID，直接用固定值插入关联表即可：

-- 插入主表
SET IDENTITY_INSERT BUSINESS_UNITS ON;
INSERT INTO BUSINESS_UNITS (id, name) VALUES (1, '总部');
SET IDENTITY_INSERT BUSINESS_UNITS OFF;

-- 用预设ID插入关联表
INSERT INTO DEPARTMENTS (business_unit_id, name) VALUES (1, '财务部');

方案2：自动获取生成的ID（适合数据库自动生成ID的场景） #

使用SQL Server的SCOPE_IDENTITY()函数获取刚生成的标识列值，在同一会话中插入关联表。注意将语句放在同一个批处理中（Quarkus按分号分隔执行批处理）：

-- 插入主表，不指定ID，由数据库生成
INSERT INTO BUSINESS_UNITS (name) VALUES ('总部');
-- 获取刚生成的ID
DECLARE @buId INT = SCOPE_IDENTITY();
-- 插入关联表
INSERT INTO DEPARTMENTS (business_unit_id, name) VALUES (@buId, '财务部');

方案3：代码实现数据预加载（开发环境更灵活方案） #

若import.sql写法繁琐，可借助Quarkus事件监听机制，在应用启动时通过Panache代码插入数据，自动处理ID与关联关系：

@ApplicationScoped
public class DevDataLoader {
    // 仅在开发环境执行（通过Profile控制）
    @Profile("dev")
    void loadDevData(@Observes StartupEvent event) {
        // 避免重复插入
        if (BusinessUnit.count() == 0) {
            BusinessUnit bu = new BusinessUnit();
            bu.setName("总部");
            bu.persist(); // 自动生成ID并保存

            Department dept = new Department();
            dept.setName("财务部");
            dept.setBusinessUnit(bu); // 直接关联实体
            dept.persist();
        }
    }
}

这种方式无需手动处理ID，Panache会自动维护关联关系，同时避免SQL语法兼容性问题。

额外注意事项 #

• 生产环境使用Flyway时，同样遵循上述SQL规则：要么开启IDENTITY_INSERT插入固定ID，要么用SCOPE_IDENTITY()关联数据。
• 确保实体类标识列注解正确：

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;
  

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