Spring Boot启动时无法自动创建MySQL表并插入初始数据

核心问题点 #

1. SQL脚本执行开关未开启：Spring Boot 2.5+版本默认不会自动执行schema.sql和data.sql，需要显式配置开启脚本初始化。
2. 表结构处理冲突：同时使用Hibernate的ddl-auto=update和手动编写的schema.sql，两者都尝试管理表结构，可能导致执行顺序冲突或报错。
3. 实体类冗余配置：@SequenceGenerator注解与主键策略GenerationType.IDENTITY不匹配，属于无效配置（不影响功能，但易混淆）。

具体调整步骤 #

1. 开启SQL脚本初始化 #

在application.properties中添加以下配置，控制脚本执行时机：

# 配置脚本执行模式：always表示每次启动都执行；when-not-exists表示仅当数据库/表不存在时执行
spring.sql.init.mode=always

# 若脚本不在默认路径（src/main/resources），需指定位置（默认可省略）
# spring.sql.init.schema-locations=classpath:schema.sql
# spring.sql.init.data-locations=classpath:data.sql

2. 选择表结构管理方式（二选一） #

方案A：依赖Hibernate自动建表（推荐）

利用JPA实体类自动生成/更新表结构，删除手动编写的schema.sql，并调整ddl-auto配置：

# 根据开发需求选择合适的ddl模式：
# create：每次启动删旧表建新表（开发环境用）
# update：仅更新表结构，保留现有数据
# validate：仅验证结构，不修改表
spring.jpa.hibernate.ddl-auto=create

方案B：手动用schema.sql管理表结构

禁用Hibernate的表结构自动生成，完全依赖自定义脚本：

# 禁止Hibernate干预表结构
spring.jpa.hibernate.ddl-auto=none

3. 清理实体类冗余配置 #

删除实体类中无效的@SequenceGenerator注解（主键用MySQL自增策略，该注解无用）：

// 删除此行
@SequenceGenerator(name="seq", initialValue=4, allocationSize=100)

4. 基础验证 #

• 确认MySQL中carsdb数据库已提前创建
• 确保root用户拥有该数据库的建表、插入数据权限
• 检查数据库连接URL、用户名、密码是否正确

验证效果 #

调整完成后启动Spring Boot应用，查看MySQL的carsdb数据库：

• 表cars会被自动创建
• data.sql中的初始数据会插入到表中

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