Spring Boot中无法通过data.sql文件初始化MySQL数据库数据

针对你遇到的data.sql数据无法填充且无报错的问题，核心原因集中在字段映射不匹配、实体关联配置缺失和SQL语句与数据库表结构不兼容这几个方面，具体分析和修复如下：

1. 实体字段与数据库列名不匹配 #

你的User实体中定义了：

@Column(name = "firstName")
private String firstName;

@Column(name = "lastName")
private String lastName;

但data.sql中使用的是下划线命名的first_name和last_name，这会导致SQL语句中的字段在数据库表中不存在（Hibernate生成的列名是firstName和lastName）。MySQL在非严格模式下会忽略不存在的字段，不会报错但数据无法正确插入。

修复：
修改data.sql中的字段名，与实体映射的列名保持一致：

REPLACE INTO user_details_master (user_id, active, email, firstName, lastName, password)
VALUES (1, 1, 'admin@gmail.com', 'Admin', 'Admin', '$2a$12$k4OMYEzgvfk6bzOldQyjnesUnRxZJvsY.JyEm2VVjCW49LSgE0t4.');

2. 关联实体的外键字段未在实体中定义 #

（1）Project与User的关联 #

User实体中List<Project>的@OneToMany没有指定@JoinColumn，Hibernate会自动生成一张中间表（比如user_project）来维护关联关系，而不是在project_master表中生成fk_user_id字段。你在data.sql中试图插入fk_user_id到project_master，但该字段根本不存在，导致数据无法插入。

修复：
在User的project字段上添加@JoinColumn，指定外键列：

@OneToMany(cascade = CascadeType.ALL)
@JoinColumn(name = "fk_user_id", referencedColumnName = "user_id")
private List<Project> project;

这样Hibernate会在project_master表中生成fk_user_id列，对应data.sql中的插入语句就会生效。

（2）Task、Bug的外键字段缺失 #

你的Task和Bug实体中没有定义fk_user_id和fk_project_id字段，所以Hibernate生成的tasks_table和bugs_table中不会有这些列。data.sql中插入这些不存在的字段时，MySQL会忽略，导致数据无法写入。

修复：
在Task和Bug实体中添加对应的外键字段并映射：

// Task.java
@ManyToOne
@JoinColumn(name = "fk_user_id")
private User user;

@ManyToOne
@JoinColumn(name = "fk_project_id")
private Project project;

// Bug.java
@ManyToOne
@JoinColumn(name = "fk_user_id")
private User user;

@ManyToOne
@JoinColumn(name = "fk_project_id")
private Project project;

或者如果不需要实体关联，只想保留数据库外键，可以直接添加字段：

// Task.java
@Column(name = "fk_user_id")
private Long fkUserId;

@Column(name = "fk_project_id")
private Long fkProjectId;

（同理修改Bug实体）

3. 自增主键与手动插入的冲突 #

你的所有实体主键都使用了GenerationType.IDENTITY（自增策略），但data.sql中手动指定了user_id、project_id等值。虽然REPLACE语句可以执行，但会打乱MySQL的自增序列，后续插入数据时可能出现主键冲突。

优化建议：
如果要手动插入初始数据，建议暂时将spring.jpa.hibernate.ddl-auto改为create-drop，或者在插入后重置自增序列：

ALTER TABLE user_details_master AUTO_INCREMENT = 2;
ALTER TABLE project_master AUTO_INCREMENT = 3;
-- 其他表同理

4. Role实体关联的缺失 #

User实体中有@OneToOne的Role关联，但你没有提供Role实体代码。data.sql中插入了roles_master的数据，但user_details_master表中的role_id字段在插入时没有赋值，会导致用户的角色关联为空。如果需要关联角色，需要在user的插入语句中添加role_id：

REPLACE INTO user_details_master (user_id, active, email, firstName, lastName, password, role_id)
VALUES (1, 1, 'admin@gmail.com', 'Admin', 'Admin', '$2a$12$k4OMYEzgvfk6bzOldQyjnesUnRxZJvsY.JyEm2VVjCW49LSgE0t4.', 1);

验证步骤 #

1. 修复上述所有问题后，启动项目，查看Hibernate的DEBUG日志（logging.level.org.hibernate.SQL=DEBUG），确认data.sql中的语句是否被执行。
2. 直接连接MySQL数据库，查看对应的表是否有数据插入。

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