如何对Knex现有迁移进行基准化处理？

1. 生成初始基准迁移文件 #

先导出生产/预发环境数据库的纯结构schema（不含业务数据），比如PostgreSQL用pg_dump --schema-only your_db_name > initial_schema.sql，MySQL用mysqldump -d your_db_name > initial_schema.sql。

创建一个优先级最高的迁移文件（比如命名为000_initial_baseline.js，序号比现有所有迁移文件小），内容示例：

exports.up = function(knex) {
  return knex.raw(`
    -- 把导出的schema SQL粘贴到这里
    CREATE TABLE users (id SERIAL PRIMARY KEY, name VARCHAR(255), email VARCHAR(255) UNIQUE);
    -- 其他表结构...
  `);
};

exports.down = function(knex) {
  // 若不需要回退旧架构，可留空；如需回退，编写对应的DROP TABLE等语句
  return knex.raw(`
    DROP TABLE users;
    -- 其他表的删除语句...
  `);
};

2. 标记基准迁移已在生产/预发环境执行 #

生产和预发库已经具备初始架构，不能重复执行基准迁移，需手动将其加入Knex的迁移记录表（默认表名knex_migrations）：

• PostgreSQL/MySQL执行SQL：

INSERT INTO knex_migrations (name, batch, migration_time) 
VALUES ('000_initial_baseline.js', 0, NOW());

（MySQL时间函数用CURRENT_TIMESTAMP，根据数据库类型调整）

执行后，Knex会识别该迁移已完成，后续运行migrate:latest只会执行之后的迁移文件。

3. 本地开发环境初始化 #

开发者只需按以下步骤操作：

• 创建本地空数据库
• 运行knex migrate:latest：Knex自动执行基准迁移生成初始架构，再依次运行后续所有迁移，同步到当前生产库结构
• 运行knex seed:run填充测试数据

4. 定期基准化的流程 #

当积累了大量迁移文件，需要再次基准化时：

1. 导出当前最新的数据库schema，创建新的基准迁移文件（比如20240601_new_baseline.js，序号大于所有现有迁移）
2. 在生产/预发库中，删除knex_migrations表中旧基准及之后的所有迁移记录
3. 插入新基准迁移的记录到knex_migrations表
4. 归档旧的迁移文件（避免混淆），告知所有开发者更新本地迁移文件后重新运行migrate:latest

注意：操作前务必备份数据库，选择低峰期执行，避免影响业务

核心注意事项 #

• 基准迁移只存schema结构，业务数据统一用种子文件管理
• 确保所有环境的knex_migrations记录完全一致，避免迁移执行冲突
• 每次基准化后，同步更新项目文档，让开发者知晓变更

内容的提问来源于stack exchange，提问作者Dhrumil Patel