Spring Boot中data.sql致PostgreSQL/MySQL报‘已存在’错误的解决咨询

首先明确：如果是开发/测试环境，用H2并配置每次启动清空确实是最省心的方案，直接在application.properties里加以下配置即可，完全避免重复创建报错：

spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
spring.sql.init.mode=always
spring.jpa.hibernate.ddl-auto=create-drop

但如果是生产环境，绝对不能采用这种会清空数据的方式，推荐用下面这些更稳妥的方案：

不用Flyway的替代方案 #

1. 控制SQL脚本的执行时机 #

Spring Boot提供了spring.sql.init.mode配置，直接管控schema.sql和data.sql的执行逻辑：

• 设为never：永远不执行初始化脚本，适合已完成数据库初始化的生产环境，第一次启动前手动执行脚本即可。
• 设为embedded：仅在使用嵌入式数据库（如H2）时执行，适配开发测试场景，切换到MySQL/PostgreSQL等生产库时自动跳过脚本执行。
• 若只是想忽略报错让应用启动，可搭配spring.sql.init.continue-on-error=true，但这属于掩盖问题，不推荐生产环境使用。

配置示例：

spring.sql.init.mode=embedded
spring.sql.init.continue-on-error=false

2. 解决data.sql的重复数据问题 #

针对不同数据库写兼容的插入语句，避免重复插入报错：

• MySQL/MariaDB：用INSERT ... ON DUPLICATE KEY UPDATE，数据存在则更新、不存在则插入：

INSERT INTO user (id, name, email) VALUES (1, '张三', 'zhangsan@example.com')
ON DUPLICATE KEY UPDATE name = VALUES(name), email = VALUES(email);

也可使用REPLACE INTO（注意：主键冲突时会删除旧数据再插入，需谨慎使用）：

REPLACE INTO user (id, name, email) VALUES (1, '张三', 'zhangsan@example.com');

• PostgreSQL：用INSERT ... ON CONFLICT DO NOTHING，直接跳过已存在的数据：

INSERT INTO user (id, name, email) VALUES (1, '张三', 'zhangsan@example.com')
ON CONFLICT (id) DO NOTHING;

• 通用方案：先查询数据是否存在，再执行插入：

INSERT INTO user (id, name, email)
SELECT 1, '张三', 'zhangsan@example.com'
WHERE NOT EXISTS (SELECT 1 FROM user WHERE id = 1);

3. 解决约束重复创建的问题 #

主流数据库现在都支持创建约束时加IF NOT EXISTS：

• MySQL 8.0.19+：创建外键/唯一约束时添加条件：

ALTER TABLE order_item
ADD CONSTRAINT fk_order_item_order_id
FOREIGN KEY (order_id) REFERENCES `order`(id)
IF NOT EXISTS;

• PostgreSQL：同样支持IF NOT EXISTS语法：

ALTER TABLE order_item
ADD CONSTRAINT fk_order_item_order_id
FOREIGN KEY (order_id) REFERENCES "order"(id)
IF NOT EXISTS;

如果是旧版本数据库不支持该语法，可先查询系统表判断约束是否存在，再执行创建语句：
比如MySQL查询information_schema.TABLE_CONSTRAINTS：

SET @constraint_exists = (SELECT COUNT(*) FROM information_schema.TABLE_CONSTRAINTS
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'order_item' AND CONSTRAINT_NAME = 'fk_order_item_order_id');

IF @constraint_exists = 0 THEN
  ALTER TABLE order_item ADD CONSTRAINT fk_order_item_order_id FOREIGN KEY (order_id) REFERENCES `order`(id);
END IF;

4. 自定义初始化逻辑 #

如果以上方案都不满足，可编写自定义初始化Bean，完全控制脚本执行条件：
比如创建DatabaseInitializer类：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.io.ClassPathResource;
import org.springframework.jdbc.datasource.init.ResourceDatabasePopulator;
import org.springframework.stereotype.Component;

import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;

@Component
public class DatabaseInitializer {

    @Autowired
    private DataSource dataSource;

    @PostConstruct
    public void initialize() {
        try (Connection conn = dataSource.getConnection()) {
            // 检查是否已初始化（比如查询标记数据或表）
            try (Statement stmt = conn.createStatement()) {
                ResultSet rs = stmt.executeQuery("SELECT COUNT(*) FROM user WHERE id = 1");
                rs.next();
                if (rs.getInt(1) == 0) {
                    // 执行初始化脚本
                    ResourceDatabasePopulator populator = new ResourceDatabasePopulator();
                    populator.addScript(new ClassPathResource("schema.sql"));
                    populator.addScript(new ClassPathResource("data.sql"));
                    populator.execute(conn);
                }
            }
        } catch (Exception e) {
            throw new RuntimeException("数据库初始化失败", e);
        }
    }
}

这样只有当标记数据不存在时，才会执行初始化脚本，完全把控执行时机。

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