Spring Boot生产环境初始化库表与初始数据的最优策略是什么

1. createDatabaseIfNotExist=true配置的生产适用性 #

绝对不推荐在生产环境使用该配置，核心原因如下：

• 权限风险：生产环境数据库账号仅会分配业务库的读写权限，不会授予建库权限，该配置要求账号具备全局CREATE DATABASE权限，一旦泄露会引发严重的数据安全风险
• 并发冲突：多实例部署时多个服务节点同时检测库不存在，会触发并发建库逻辑，大概率导致服务启动失败
• 管控缺失：生产环境所有库表变更都需要走变更审批、操作留痕流程，自动建库操作无法纳入正常的变更管控体系，故障溯源难度极高

2. 生产环境常用的库表初始化&数据预置方案 #

生产环境优先选择版本化数据库迁移工具实现可控的初始化操作，不会直接使用Spring Boot原生的data.sql/ddl-auto配置，以下是两种成熟方案的示例：

方案一：Flyway 版本化迁移（最常用） #

Flyway会按版本号顺序执行SQL脚本，执行过的脚本会自动记录，不会重复执行，天然支持多实例部署。

步骤1 引入依赖（Maven示例）

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-mysql</artifactId>
</dependency>

步骤2 配置文件（application-prod.yml示例）

spring:
  datasource:
    # 生产环境提前通过DBA流程建好库，不要加自动建库参数
    url: jdbc:mysql://localhost:3306/users?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: prod_user
    password: ${DB_PASSWORD} # 从环境变量读取密码，禁止硬编码
  flyway:
    enabled: true
    # 脚本存放位置
    locations: classpath:db/migration
    # 生产环境禁用clean操作，避免误删全库数据
    clean-disabled: true
    # 禁止乱序执行脚本，保证版本一致性
    out-of-order: false

步骤3 编写迁移脚本

在resources/db/migration目录下按V{版本号}__{脚本描述}.sql规则命名脚本：

• 建表脚本：V1__init_user_table.sql

CREATE TABLE IF NOT EXISTS `user` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `username` varchar(64) NOT NULL,
  `password` varchar(128) NOT NULL,
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

• 预置用户脚本：V2__init_default_users.sql

-- 密码提前加密后写入，不要存明文，示例为BCrypt加密后的123456
-- INSERT IGNORE避免脚本重复执行时主键冲突
INSERT IGNORE INTO `user` (`username`, `password`) VALUES 
('admin', '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKX2m'),
('operator', '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKX2m');

首次启动会自动执行所有脚本，后续版本迭代只需要新增更高版本号的脚本即可。

方案二：Liquibase 结构化迁移（适合多数据库兼容场景） #

Liquibase支持XML/YAML/JSON/SQL多种格式的迁移脚本，更容易实现跨数据库类型兼容。

配置示例（application-prod.yml）

spring:
  liquibase:
    enabled: true
    change-log: classpath:db/changelog/db.changelog-master.yaml
    # 生产环境禁止启动前清空库
    drop-first: false

所有变更都会记录到数据库的变更日志表中，支持版本回滚，适合需要兼容多种数据库的业务场景。

方案三：轻量服务自定义初始化逻辑 #

如果是非常轻量的内部服务，不想引入额外迁移组件，可以通过Spring的ApplicationRunner实现可控的初始化：

@Component
@ConditionalOnProperty(name = "app.init-data.enable", havingValue = "true")
public class UserDataInitializer implements ApplicationRunner {
    @Autowired
    private JdbcTemplate jdbcTemplate;
    @Autowired
    private PasswordEncoder passwordEncoder;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        // 先判断用户表是否存在，不存在才建表
        Integer tableExist = jdbcTemplate.queryForObject(
            "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'users' AND TABLE_NAME = 'user'",
            Integer.class
        );
        if (tableExist == 0) {
            jdbcTemplate.execute("CREATE TABLE `user` (id bigint NOT NULL AUTO_INCREMENT, username varchar(64) NOT NULL, password varchar(128) NOT NULL, PRIMARY KEY (id), UNIQUE KEY uk_username (username)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");
        }
        // 判断预置用户是否存在，不存在才插入
        Integer adminExist = jdbcTemplate.queryForObject(
            "SELECT COUNT(*) FROM `user` WHERE username = 'admin'",
            Integer.class
        );
        if (adminExist == 0) {
            jdbcTemplate.update(
                "INSERT INTO `user` (username, password) VALUES (?, ?)",
                "admin", passwordEncoder.encode("自定义初始密码")
            );
        }
    }
}

对应配置文件增加开关，生产环境首次启动打开，后续可以关闭避免不必要的校验：

app:
  init-data:
    enable: true

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