当前位置：首页 > news >正文

如何优雅地完成项目数据库的初始化

news 2026/4/18 19:55:20

简介

当项目在一个新的环境启动或部署时，必不可少的步骤是完成数据库的初始化

将所需要的数据库表，可能还有一些初始的配置数据一次性写入到数据库中

常规的做法，是将初始化脚本整理到项目的资源目录中，提醒开发程序员或者运维人员在部署时手动执行

本文介绍如何优化地完成这个动作，将初始化脚本写入到项目的配置文件中，项目启动时，自动执行该脚本，完成数据库的初始化

配置

简单来说，是在 application.yml 文件中，增加下面这个配置，指定项目启动时加载的数据库脚本

spring:# 数据库连接配置（先连接到MySQL服务器，不指定数据库）datasource:url:jdbc:mysql://localhost:3306/?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=trueusername:rootpassword:123456driver-class-name:com.mysql.cj.jdbc.Driver# 核心配置：自动执行SQL初始化数据库sql:init:# 开启SQL初始化（SpringBoot 2.5+ 默认关闭，必须手动开启）mode:always# 指定要执行的SQL路径（多个用逗号分隔）schema-locations:classpath:init.sql# 编码（解决中文乱码）encoding:utf-8

init.sql内容如下，是数据库的初始化脚本，注意这个脚本应设计成幂等的，即多次执行效果相同

具体来说，就是创建前先判断是否存在，存在了就不创建，不存在才创建

-- =============================================-- 数据库初始化脚本-- 优雅初始化数据库演示项目-- =============================================-- 创建数据库（如果不存在）CREATEDATABASEIFNOTEXISTS`db_elegant`DEFAULTCHARACTERSETutf8mb4COLLATEutf8mb4_unicode_ci;-- 使用该数据库USE`db_elegant`;-- 创建用户表（如果不存在）CREATETABLEIFNOTEXISTS`db_elegant`.`user`(`id`BIGINTNOTNULLAUTO_INCREMENTCOMMENT'主键ID',`username`VARCHAR(50)NOTNULLCOMMENT'用户名',`email`VARCHAR(100)DEFAULTNULLCOMMENT'邮箱',`age`INTDEFAULTNULLCOMMENT'年龄',`created_at`DATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',`updated_at`DATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMPCOMMENT'更新时间',PRIMARYKEY(`id`),UNIQUEKEY`uk_username`(`username`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4COMMENT='用户表';-- 创建商品表（如果不存在）CREATETABLEIFNOTEXISTS`db_elegant`.`product`(`id`BIGINTNOTNULLAUTO_INCREMENTCOMMENT'主键ID',`name`VARCHAR(100)NOTNULLCOMMENT'商品名称',`description`VARCHAR(500)DEFAULTNULLCOMMENT'商品描述',`price`DECIMAL(10,2)NOTNULLDEFAULT0.00COMMENT'价格',`stock`INTNOTNULLDEFAULT0COMMENT'库存',`created_at`DATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',`updated_at`DATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMPCOMMENT'更新时间',PRIMARYKEY(`id`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4COMMENT='商品表';-- 插入测试数据（数据不存在时才插入）INSERTIGNOREINTO`db_elegant`.`user`(`username`,`email`,`age`)VALUES('张三','zhangsan@example.com',25),('李四','lisi@example.com',30),('王五','wangwu@example.com',28);INSERTIGNOREINTO`db_elegant`.`product`(`name`,`description`,`price`,`stock`)VALUES('iPhone 15 Pro','苹果最新款手机',8999.00,100),('MacBook Pro 14英寸','M3芯片专业笔记本',14999.00,50),('AirPods Pro','主动降噪耳机',1899.00,200);-- 输出初始化完成信息SELECT'数据库初始化完成！'ASmessage;