spring: datasource: url: jdbc:mysql://localhost:/liquibase_demo?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8 username: root password: driver-class-name: com.mysql.cj.jdbc.Driver liquibase: enabled: true change-log: classpath:db/changelog/db.changelog-master.yaml contexts: dev

先说说为啥要追踪数据库变geng

你说啊，项目里改表结构，那是常有的事儿。

可是一不小心，生产库多了几个字段，测试库少了几张表。

这时候谁来负责？谁来解释？

别慌，LiquiBase 就是帮你把这些“历史脚印”全记录下来。

哈哈，一句话概括：让数据库像代码一样，可回滚、可审计。

Liquibase 基本概念速递

Zui核心的东西叫 changeSet。

每个 changeSet 必须有唯一的 id + author 组合。

它就像一条小命令，执行一次后会在内部表里打上标记。

下次启动，Liquibase 会去查 DATABASECHANGELOG 表，kan哪些Yi经跑过哪些还没跑。

于是只会执行未执行的那部分，省得重复跑 SQL。

怎么把 changeSet 写进项目

Zui常见的Zuo法是用 YAML 或 XML，甚至Ke以直接写 formatted SQL。

下面给你一个Zui基础的例子：

databaseChangeLog:
  - changeSet:
      id: -create-users-table
      author: feng
      changes:
        - createTable:
            tableName: users
            columns:
              - column:
                  name: id
                  type: bigint
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: username
                  type: varchar
                  constraints:
                    nullable: false
              - column:
                  name: email
                  type: varchar
                  constraints:
                    nullable: false
        - addUniqueConstraint:
            tableName: users
            columnNames: email
            constraintName: uk_users_email
      rollback:
        - dropTable:
            tableName: users

这个 changeSet Zuo了两件事：建表 + 加唯一索引。

还有回滚逻辑：删表。

环境隔离：context & label

实际项目里你肯定有 dev、test、prod 三套环境。

context 就是帮你过滤——只在匹配的环境里跑对应的 changeSet。

changeSet:
  id: init-dev-data
  author: feng
  context: dev,test   # 只在 dev 和 test 环境执行
  changes:
    - insert:
        tableName: users
        columns:
          - column:{name:"username",value:"张三"}
          - column:{name:"email",value:""}
          - column:{name:"age",valueNumeric:"28"}
          - column:{name:"created_at",valueDate:"2024-01-01T10::00"}

Ru果想按业务模块划分，就Ke以用 tag/label，比如 tag=order-module.

Maven / Gradle 插件玩转自动化

Maven 项目里加上插件配置，一键搞定：

    org.liquibase
    liquibase-maven-plugin
    ${liquibase.version}
    
        src/main/resources/db/changelog/db.changelog-master.yaml
        ${jdbc.url}
        ${jdbc.username}
        ${jdbc.password}
        ${jdbc.driver}
    

Maven 命令随便敲：

mvn liquibase:update

mvn liquibase:updateSQL

mvn liquibase:rollback -Dliquibase.rollbackCount=1

Maven 与 CI/CD 的完美结合

CICD 流水线里直接跑同样的 Maven 命令，让每次发布dou自动同步数据库结构。

回滚策略—别等到线上出锅才慌乱

AWS 那边我曾经遇到过一次“字段太长导致插入失败”。

B站朋友也碰到过“误删列”。

L​iquibase 的好处就是你提前写好 rollback 脚本，出问题只要执行一次回滚命令就Neng恢复到前一个版本。

changeSet:
  id: add-user-phone-column
  author: feng
  changes:
    - addColumn:
        tableName: users
        columns:
          - column:{name:"phone",type:"varchar",defaultValue:"",constraints:{nullable:false}}
  rollback:
    - dropColumn:
        tableName: users
        columnName: phone

"为什么百度不收录"这件事儿——顺便聊聊 SEO 小插曲吧 😆

有人问：“我把 Liquibase 文档放在公司博客上，百度竟然不收录？”

# 不对不对，这其实跟内容本身关系大。

#1 内容重复度高：Baidu 喜欢原创、唯一的文字。Ru果你直接复制官方文档，那搜索引擎会认为没有价值，自然不收录。

#2 缺少有效外链：Baidu 抓取页面时会参考外部链接权重，Ru果页面孤立无援，也容易被忽略。

#3 没Zuo好 Meta 信息：