基于档案制度的数据一致性保障实操指南

一、环境准备与工具安装

要实现基于档案制度的数据一致性，我们需要使用数据库版本控制工具。本指南以 Liquibase 结合 MySQL 为例，构建一套不可篡改、可追溯的数据库变更档案体系。请严格按照以下步骤准备环境。

1. 安装 MySQL 数据库

确保系统中已安装 MySQL 5.7 或 8.0 版本。如果未安装，请执行以下命令（以 Ubuntu 为例）：

sudo apt-get update
sudo apt-get install mysql-server -y
sudo systemctl start mysql
sudo mysql_secure_installation

安装完成后，创建一个专用数据库用于本实操演练：

mysql -u root -p -e "CREATE DATABASE archive_demo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -u root -p -e "CREATE USER 'archive_user'@'localhost' IDENTIFIED BY 'StrongPass123!';"
mysql -u root -p -e "GRANT ALL PRIVILEGES ON archive_demo. TO 'archive_user'@'localhost';"
mysql -u root -p -e "FLUSH PRIVILEGES;"

2. 安装 Liquibase

Liquibase 是核心工具，用于记录每一次数据库变更，形成“档案”。请直接下载并解压：

wget https://github.com/liquibase/liquibase/releases/download/v4.25.1/liquibase-4.25.1.tar.gz
tar -xzf liquibase-4.25.1.tar.gz
sudo mv liquibase /usr/local/bin/

下载 MySQL JDBC 驱动，这是 Liquibase 连接数据库的必要组件：

cd /usr/local/bin/liquibase/lib
wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.33/mysql-connector-java-8.0.33.jar

二、构建档案目录结构

在项目根目录下创建标准化的目录结构，用于存放不同类型的数据库变更档案。执行以下命令：

mkdir -p db-archive/changelog
mkdir -p db-archive/sql
cd db-archive

这个结构将变更集与原始 SQL 分离，便于管理。接下来，创建 Liquibase 的配置文件 liquibase.properties，这是档案制度的入口文件。

cat > liquibase.properties << 'EOF'
驱动类名
driver: com.mysql.cj.jdbc.Driver
数据库连接URL
url: jdbc:mysql://localhost:3306/archive_demo?useSSL=false&serverTimezone=UTC
用户名
username: archive_user
密码
password: StrongPass123!
主变更日志文件路径（档案索引）
changeLogFile: changelog/db.changelog-master.xml
输出详细日志
logLevel: info
EOF

三、定义初始数据结构档案

我们需要定义一个主变更日志文件，它相当于档案的“总目录”。创建 changelog/db.changelog-master.xml：

cat > changelog/db.changelog-master.xml << 'EOF'





EOF

接下来，创建具体的变更集文件 changelog/init-schema.xml。这个文件定义了表结构，id 和 author 标签构成了档案的唯一标识，严禁重复。

cat > changelog/init-schema.xml << 'EOF'
















DROP TABLE t_user;


EOF

四、执行档案同步

配置完成后，执行 update 命令将变更应用到数据库。这一步会将 XML 定义转化为真实的数据库表，并在数据库中记录两张特殊的“档案表”：DATABASECHANGELOG 和 DATABASECHANGELOGLOCK。

liquibase update

预期输出验证：

执行成功后，你会看到 "Liquibase 'update' successful" 的提示。此时，登录数据库验证表结构及档案表：

mysql -u archive_user -p'StrongPass123!' archive_demo -e "SHOW TABLES;"

输出应包含：t_user, DATABASECHANGELOG, DATABASECHANGELOGLOCK。

查看 DATABASECHANGELOG 表的内容，这就是我们的“执行档案”：

mysql -u archive_user -p'StrongPass123!' archive_demo -e "SELECT id, author, filename, md5sum FROM DATABASECHANGELOG;"

你会看到刚才定义的 create-user-table 记录，以及该文件的 MD5 校验和。这就是数据一致性的核心保障：任何对 XML 文件的非法修改都会导致 MD5 变化，Liquibase 将会拒绝执行。

五、增量变更与一致性校验

档案制度要求所有变更必须增量记录。现在我们模拟一个业务需求：给用户表添加一个状态字段。

创建新的变更集文件 changelog/add-status-column.xml：

cat > changelog/add-status-column.xml << 'EOF'








ALTER TABLE t_user DROP COLUMN status;


EOF

关键步骤：必须将新文件加入到主目录 db.changelog-master.xml 中。修改该文件：

cat > changelog/db.changelog-master.xml << 'EOF'






EOF

再次执行更新：

liquibase update

验证字段是否添加成功：

mysql -u archive_user -p'StrongPass123!' archive_demo -e "DESCRIBE t_user;"

六、模拟人为破坏与一致性检测

这是档案制度最核心价值的体现：防止“私自修改”。假设开发人员绕过 Liquibase，直接在数据库中手动修改了表结构，导致档案记录与实际数据库不一致。

步骤 1：手动破坏数据库结构

直接删除刚才添加的 status 字段：

mysql -u archive_user -p'StrongPass123!' archive_demo -e "ALTER TABLE t_user DROP COLUMN status;"

步骤 2：运行一致性校验

使用 status 命令检查档案记录与实际数据库的差异：

liquibase status

输出分析：

你将看到 1 个 "not applied" 的条目（因为 Liquibase 认为它需要执行），但实际上数据库中可能残留旧结构或结构已被篡改。更严格的检查是使用 diff 命令对比基准。

为了演示自动校验机制，我们尝试再次运行 update。由于数据库中缺少该字段，Liquibase 会尝试重新添加，这可能会报错（如果字段已存在）或成功覆盖。但在严格的档案制度下，我们应先检查 DATABASECHANGELOG 的 MD5。

假设我们修改了 add-status-column.xml 的内容（例如把 defaultValue 改为 0），但不改变 ID：

sed -i 's/defaultValue="1"/defaultValue="0"/' changelog/add-status-column.xml

再次执行 liquibase update。Liquibase 会检测到 MD5 Checksum 不匹配，并抛出安全错误，拒绝执行。这就是档案制度保证数据一致性的铁律：已执行的变更集不可篡改。

解决校验错误：

如果确认需要修改（必须经过审批流程），需使用 clearChecksums 清除校验和（仅限紧急修复），然后重新生成校验和：

liquibase clearChecksums
liquibase update

七、档案回滚操作

当新上线代码出现严重问题，需要依据档案回滚到上一版本。Liquibase 可以利用我们在 changeSet 中定义的 标签执行回滚。

执行回滚到最后一个变更集：

liquibase rollbackCount 1

验证数据库结构：

mysql -u archive_user -p'StrongPass123!' archive_demo -e "DESCRIBE t_user;"

你会发现 status 字段已经被删除，数据库状态恢复到了变更之前。同时，DATABASECHANGELOG 表中对应的记录也会被删除，保持了档案与实物的一致性。