Spring Boot通过SQL插入数据后自增ID冲突问题求助

这个问题我之前也碰到过，核心原因是MySQL的AUTO_INCREMENT计数器在手动插入指定ID的记录后不会自动更新，而Hibernate依赖这个计数器生成新ID，所以才会出现主键重复的错误。结合你的场景（create-drop模式+data.sql插入测试数据），给你几个实用的解决办法：

方法1：修改data.sql，不指定ID让MySQL自动生成 #

如果测试数据不需要固定ID，直接在插入语句中省略user_id字段，让MySQL自动分配自增ID，这样计数器会自动跟进：

-- 省略user_id，让MySQL自动生成
INSERT INTO users (user_name, email, password, name, last_name, active, phone_number, address_id)
VALUES 
('testuser1', 'test1@example.com', 'pass123', 'Alice', 'Smith', true, '13000000001', 1),
('testuser2', 'test2@example.com', 'pass123', 'Bob', 'Jones', true, '13000000002', 2),
('testuser3', 'test3@example.com', 'pass123', 'Charlie', 'Brown', true, '13000000003', 3);

这样Hibernate后续生成的ID会接着MySQL的计数器走，完全不会有冲突。

方法2：插入数据后手动更新自增计数器 #

如果必须保留固定ID的测试数据，在data.sql的最后添加一条SQL语句，强制把users表的AUTO_INCREMENT设置为最大ID+1：

-- 先插入3条指定ID的测试数据
INSERT INTO users (user_id, user_name, email, password, name, last_name, active, phone_number, address_id)
VALUES 
(1, 'testuser1', 'test1@example.com', 'pass123', 'Alice', 'Smith', true, '13000000001', 1),
(2, 'testuser2', 'test2@example.com', 'pass123', 'Bob', 'Jones', true, '13000000002', 2),
(3, 'testuser3', 'test3@example.com', 'pass123', 'Charlie', 'Brown', true, '13000000003', 3);

-- 更新自增计数器为4，确保下一个ID从4开始
ALTER TABLE users AUTO_INCREMENT = 4;

因为你用的是create-drop模式，每次启动都会重建表并执行data.sql，所以这条语句每次都会生效，彻底避免冲突。

方法3：通过Spring Boot初始化Bean自动调整计数器 #

如果测试数据的数量可能变化，手动写死AUTO_INCREMENT = 4不够灵活，可以写一个初始化Bean，启动时自动查询最大ID并设置计数器：

@Component
public class AutoIncrementInitializer implements ApplicationListener<ContextRefreshedEvent> {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        // 查询users表的最大user_id
        Integer maxUserId = jdbcTemplate.queryForObject("SELECT MAX(user_id) FROM users", Integer.class);
        if (maxUserId != null) {
            // 设置自增计数器为最大ID+1
            jdbcTemplate.execute("ALTER TABLE users AUTO_INCREMENT = " + (maxUserId + 1));
        }
    }
}

这个方法会在Spring容器启动完成后自动执行，不管你插入多少条测试数据，都能保证计数器正确。

补充说明：为什么AUTO/IDENTITY策略没用？ #

你尝试过GenerationType.AUTO和IDENTITY但没解决问题，是因为：

• 在MySQL中，AUTO会自动映射为IDENTITY，本质都是依赖MySQL的AUTO_INCREMENT机制。
• 当你手动插入指定ID的记录时，MySQL不会自动更新AUTO_INCREMENT的值，只有当插入的ID大于当前计数器值时，计数器才会更新。比如你插入了ID=3，但计数器还是1，Hibernate生成的下一个ID就是1，自然冲突。

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