如何为knex迁移及锁文件指定自定义schema并提前创建对应schema

DevOps 小满

2026-10-1

解决方案

方法1：使用knex内置的`beforeMigrations`钩子（推荐，适配knex 0.95.0及以上版本）

该钩子会在knex初始化迁移表之前自动执行，刚好可以用来提前创建不存在的schema，修改后的配置如下：

const config = {
  client: "postgresql",
  connection: {
    database: DB_NAME,
    user: DB_USER,
    password: DB_PASSWORD,
    host: DB_HOST,
  },
  migrations: {
    schemaName: "custom_schema",
    tableName: "knex_migrations",
  },
  // 新增前置执行逻辑
  async beforeMigrations(knex) {
    // 使用参数绑定避免注入风险，IF NOT EXISTS保证重复执行不会报错
    await knex.raw(`CREATE SCHEMA IF NOT EXISTS ??`, ["custom_schema"]);
  }
};

修改后直接执行原有迁移命令即可正常运行。

方法2：低版本knex兼容方案

如果使用的knex版本低于0.95.0，没有内置beforeMigrations钩子，可以单独编写预执行脚本，先完成schema创建再运行迁移：

新建run-migration.js文件：

const knex = require('knex');
const config = require('./knexfile'); // 替换为你的knex配置文件实际路径

async function run() {
  const db = knex(config);
  // 先创建目标schema
  await db.raw(`CREATE SCHEMA IF NOT EXISTS ??`, ["custom_schema"]);
  // 再执行迁移逻辑
  await db.migrate.latest();
  await db.destroy();
}

run().catch(err => {
  console.error('迁移执行失败：', err);
  process.exit(1);
});