分为4 种主流实现方式按企业规范优先级排序Flyway首选 Liquibase JPA/MyBatis-Plus 自动建表 Navicat 手动建表结合表格对比、实操步骤、适用场景、踩坑要点讲解贴合你当前后台员工权限系统开发场景。一、四种建表方案横向对比总表对比维度Flyway推荐LiquibaseJPA 自动建表Navicat 手动建表核心原理SQL 脚本版本化管理项目启动顺序执行 DDLXML/YAML 结构化定义 SQL跨数据库适配根据 Java 实体类注解反向生成数据表可视化工具手动点击创建表脚本存储位置项目 resources/db/migration 目录纳入 Git 版本管理项目资源目录 xml 文件纳入 Git仅 Java 实体类无独立 SQL 文件SQL 不存入项目代码仓库多环境一致性本地 /dev/ 测试 / 生产表结构 100% 统一多环境完全一致极易出现环境表结构差异多环境完全不一致无法追溯版本回滚能力免费版仅支持正向补丁回滚商业版 Undo 回滚原生支持任意版本一键回滚无回滚能力极易丢数据无任何回滚、版本记录学习成本极低会写 MySQL SQL 即可上手中等需要学习专属标签语法低依赖注解配置上手最简单适用场景绝大多数 Java 后端、MySQL 单库项目多数据库混用MySQL/Oracle/PG、外企项目本地快速调试原型正式环境禁用临时测试建表禁止迭代使用国内企业普及率85% 以上中小后端团队标配15% 左右多数据库场景项目初创项目本地调试个人临时测试二、方案一Flyway 建表详细实操你项目当前最优选择1. 依赖引入Maven pom.xmlSpringBoot2 / SpringBoot3 通用依赖!-- flyway 核心依赖 -- dependency groupIdorg.flywaydb/groupId artifactIdflyway-core/artifactId /dependency !-- MySQL驱动依赖必须存在 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency2. 目录规范固定路径不可随意修改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版本号__描述文字.sqlV 开头代表可执行一次的迁移脚本两个下划线__分割版本号和描述版本号必须从小到大递增已经执行过的脚本内容永远不能修改。3. 编写建表 SQL 示例角色权限表文件V1__init_sys_role_table.sqlCREATE 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) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT系统角色表; -- 可顺带初始化默认管理员角色数据 INSERT INTO sys_role(role_name,role_code,sort) VALUES (超级管理员,admin,1);4. application.yml 配置开启 Flywayspring: # 数据库数据源配置对接本地/dev MySQL datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://数据库地址:3306/库名?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: 账号 password: 密码 flyway: enabled: true # 开启自动迁移 locations: classpath:db/migration # 脚本扫描路径 baseline-on-migrate: true # 老项目已有数据表自动初始化基线 validate-on-migrate: true # 校验脚本完整性线上必须开启 clean-disabled: true # 禁止clean清空库防止线上误删表5. 执行建表启动 SpringBoot 项目项目启动时自动扫描未执行 SQL 脚本依次执行建表语句数据库自动生成两张表sys_role你自己新建的业务表flyway_schema_historyFlyway 版本记录表存储所有脚本执行日志三、方案二Liquibase 建表跨数据库场景使用核心特点不直接写原生 MySQL SQL用 XML/YAML 统一描述表结构可一键生成 MySQL、Oracle、PostgreSQL 多数据库兼容语句适合需要切换多种数据库的项目。 基础文件示例?xml version1.0 encodingUTF-8? databaseChangeLog xmlnshttp://www.liquibase.org/xml/ns/dbchangelog changeSet id1 authordev createTable tableNamesys_role column nameid typeBIGINT autoIncrementtrue constraints primaryKeytrue/ /column column namerole_name typeVARCHAR(50) constraints nullablefalse/ /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弊端字段注释、索引、字符集无法精细定义字段删除、修改极易造成数据丢失多环境结构无法统一上线极易出问题。五、方案四Navicat/DBeaver 客户端手动建表临时测试打开数据库连接 → 选中业务库 → 右键新建表可视化填写字段、主键、索引保存致命缺陷表结构只存在当前连接的数据库没有 SQL 脚本存入项目推送至 dev、测试、生产环境需要手动逐台执行多人协作结构混乱没有版本记录结构出错无法回滚追溯。六、建好的表如何推送到 dev 服务器完整上线流程标准 CI/CD 流水线步骤提交代码至 Git 仓库将V1__xxx.sql脚本文件提交、push 到 GitLab/Gitee dev 开发分支Jenkins 自动化打包部署运维流水线拉取最新代码 → 打包 Jar 包 → 上传部署到 dev 服务器服务器启动项目自动执行建表dev 环境后端服务启动时Flyway 读取项目内未执行的 SQL 脚本自动在 dev 云端数据库创建数据表验证连接 dev 数据库刷新库即可看到新建数据表。无自动化流水线简易推送方式本地执行脚本导出完整建表 SQL连上 dev 数据库手动把 SQL 语句全部执行一遍 缺点无版本管理仅临时应急使用。七、日常迭代修改表结构规范新增字段 / 索引7.1、永远不要修改已经上线的 V1、V2 脚本内容7.2、新建更高版本脚本V4__add_column_to_role.sql7.3、脚本内写 ALTER 语句修改表-- 角色表新增状态字段 ALTER TABLE sys_role ADD COLUMN status TINYINT DEFAULT 1 COMMENT 状态 1启用 0禁用;7.4、提交代码发布所有环境自动同步变更。八、高频报错 解决方案对照表报错信息根因解决办法Validate failed checksum mismatch已执行过的脚本被修改哈希校验失败本地恢复脚本原始内容已上线执行mvn flyway:repairFound non-empty schema without metadata table数据库已有存量表无 Flyway 版本表开启baseline-on-migrate: trueSQL syntax error脚本内 MySQL 语法错误核对 SQL 语句修正后重新启动Unknown database host xxx无法解析 dev 数据库域名电脑连接公司 VPN打通内网访问权限启动成功但数据表没有生成Flyway 未扫描到脚本目录核对路径resources/db/migration 路径无误总结企业开发唯一标准方案Flyway SQL 脚本版本化管理所有建表、改字段、加索引全部写 SQL 脚本纳入代码仓库本地调试验证无误后提交代码流水线发布自动同步所有环境表结构JPA 自动建表、Navicat 手动建表仅限本地原型调试禁止上线使用。