Java：SpringBoot 项目建表完整方案全景梳理

分为4 种主流实现方式，按企业规范优先级排序：Flyway（首选）> Liquibase > JPA/MyBatis-Plus 自动建表 > Navicat 手动建表；结合表格对比、实操步骤、适用场景、踩坑要点讲解，贴合你当前后台员工权限系统开发场景。

一、四种建表方案横向对比总表

二、方案一：Flyway 建表详细实操（你项目当前最优选择）

1. 依赖引入（Maven pom.xml）

SpringBoot2 / SpringBoot3 通用依赖

<!-- flyway 核心依赖 --> <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> </dependency> <!-- MySQL驱动依赖（必须存在） --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>

2. 目录规范（固定路径不可随意修改）

src/main/resources/ └── db └── migration # Flyway固定扫描文件夹 ├── V1__init_sys_role_table.sql # 版本1：创建角色表 ├── V2__init_sys_user_table.sql # 版本2：创建用户表 └── V3__add_sort_column_role.sql # 版本3：后续新增字段脚本

文件名强制命名规则

V版本号__描述文字.sql

1. V 开头代表可执行一次的迁移脚本；

2. 两个下划线__分割版本号和描述；

3. 版本号必须从小到大递增，已经执行过的脚本内容永远不能修改。

3. 编写建表 SQL 示例（角色权限表）

文件：V1__init_sys_role_table.sql

CREATE TABLE `sys_role` ( id BIGINT AUTO_INCREMENT COMMENT '主键id', role_name VARCHAR(50) NOT NULL COMMENT '角色名称', role_code VARCHAR(50) NOT NULL COMMENT '角色唯一编码', sort INT DEFAULT 0 COMMENT '排序号', create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (id), UNIQUE INDEX uk_role_code (role_code) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统角色表'; -- 可顺带初始化默认管理员角色数据 INSERT INTO sys_role(role_name,role_code,sort) VALUES ('超级管理员','admin',1);

4. application.yml 配置开启 Flyway

spring: # 数据库数据源配置（对接本地/dev MySQL） datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://数据库地址:3306/库名?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: 账号 password: 密码 flyway: enabled: true # 开启自动迁移 locations: classpath:db/migration # 脚本扫描路径 baseline-on-migrate: true # 老项目已有数据表自动初始化基线 validate-on-migrate: true # 校验脚本完整性，线上必须开启 clean-disabled: true # 禁止clean清空库，防止线上误删表

5. 执行建表

1. 启动 SpringBoot 项目；

2. 项目启动时自动扫描未执行 SQL 脚本，依次执行建表语句；

3. 数据库自动生成两张表：

   1. sys_role：你自己新建的业务表

   2. flyway_schema_history：Flyway 版本记录表，存储所有脚本执行日志

三、方案二：Liquibase 建表（跨数据库场景使用）

核心特点

不直接写原生 MySQL SQL，用 XML/YAML 统一描述表结构，可一键生成 MySQL、Oracle、PostgreSQL 多数据库兼容语句；适合需要切换多种数据库的项目。 基础文件示例：

<?xml version="1.0" encoding="UTF-8"?> <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"> <changeSet id="1" author="dev"> <createTable tableName="sys_role"> <column name="id" type="BIGINT" autoIncrement="true"> <constraints primaryKey="true"/> </column> <column name="role_name" type="VARCHAR(50)"> <constraints nullable="false"/> </column> </createTable> </changeSet> </databaseChangeLog>

启动项目自动解析 XML 建表，国内普通 MySQL 项目很少使用。

四、方案三：JPA / MyBatis-Plus 实体类自动建表（仅本地调试）

依靠 Java 实体类注解反向生成数据表，正式环境绝对禁止开启，表结构无法精准控制。

1. JPA 示例

@Entity @Table(name = "sys_role") public class SysRole { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @Column(nullable = false, length = 50) private String roleName; // get/set省略 }

yml 配置：

spring: jpa: hibernate: ddl-auto: update # update: 自动根据实体更新表结构 show-sql: true

弊端

1. 字段注释、索引、字符集无法精细定义；

2. 字段删除、修改极易造成数据丢失；

3. 多环境结构无法统一，上线极易出问题。

五、方案四：Navicat/DBeaver 客户端手动建表（临时测试）

1. 打开数据库连接 → 选中业务库 → 右键新建表；

2. 可视化填写字段、主键、索引保存；

致命缺陷

• 表结构只存在当前连接的数据库，没有 SQL 脚本存入项目；

• 推送至 dev、测试、生产环境需要手动逐台执行，多人协作结构混乱；

• 没有版本记录，结构出错无法回滚追溯。

六、建好的表如何推送到 dev 服务器（完整上线流程）

标准 CI/CD 流水线步骤

1. 提交代码至 Git 仓库将V1__xxx.sql脚本文件提交、push 到 GitLab/Gitee dev 开发分支；

2. Jenkins 自动化打包部署运维流水线拉取最新代码 → 打包 Jar 包 → 上传部署到 dev 服务器；

3. 服务器启动项目自动执行建表dev 环境后端服务启动时，Flyway 读取项目内未执行的 SQL 脚本，自动在 dev 云端数据库创建数据表；

4. 验证：连接 dev 数据库，刷新库即可看到新建数据表。

无自动化流水线简易推送方式

1. 本地执行脚本导出完整建表 SQL；

2. 连上 dev 数据库，手动把 SQL 语句全部执行一遍； 缺点：无版本管理，仅临时应急使用。

七、日常迭代修改表结构规范（新增字段 / 索引）

7.1、永远不要修改已经上线的 V1、V2 脚本内容；

7.2、新建更高版本脚本：V4__add_column_to_role.sql；

7.3、脚本内写 ALTER 语句修改表：

-- 角色表新增状态字段 ALTER TABLE sys_role ADD COLUMN status TINYINT DEFAULT 1 COMMENT '状态 1启用 0禁用';

7.4、提交代码发布，所有环境自动同步变更。

八、高频报错 & 解决方案对照表

总结

1. 企业开发唯一标准方案：Flyway + SQL 脚本版本化管理；

2. 所有建表、改字段、加索引全部写 SQL 脚本纳入代码仓库；

3. 本地调试验证无误后提交代码，流水线发布自动同步所有环境表结构；

4. JPA 自动建表、Navicat 手动建表仅限本地原型调试，禁止上线使用。