咨询：在Waterline/Sails环境中使用Knex管理数据库迁移的可行性

完全可以用Knex.js来管理Sails应用的数据库迁移！其实很多Sails开发者都会因为Waterline的迁移能力有限（比如复杂表结构变更、自定义SQL支持不足），转而用Knex来接管迁移逻辑，甚至可以和Waterline配合使用，互不冲突。下面一步步给你讲怎么操作：

1. 安装必要依赖 #

首先安装Knex和对应的数据库驱动（比如PostgreSQL用pg，MySQL用mysql2，SQLite用sqlite3）：

npm install knex --save
# 以PostgreSQL为例，安装对应驱动
npm install pg --save

2. 初始化Knex配置 #

运行下面的命令生成Knex的配置文件knexfile.js：

npx knex init

打开这个文件，配置对应环境（开发/测试/生产）的数据库连接，要和Sails的数据库配置保持一致，示例如下：

module.exports = {
  development: {
    client: 'postgresql',
    connection: {
      database: 'your_sails_dev_db',
      user:     'your_db_user',
      password: 'your_db_password'
    },
    migrations: {
      tableName: 'knex_migrations' // Knex用来记录迁移状态的表名
    }
  },
  test: {
    // 测试环境配置，逻辑与开发环境一致
  },
  production: {
    // 生产环境建议用环境变量读取配置
    client: 'postgresql',
    connection: process.env.DATABASE_URL,
    migrations: {
      tableName: 'knex_migrations'
    }
  }
};

3. 创建迁移文件 #

Knex支持版本化的迁移文件，比如要创建一个用户表，运行：

npx knex migrate:make create_users_table

这会在项目根目录生成migrations文件夹，里面有一个带时间戳的迁移文件，编辑它来定义表结构：

exports.up = function(knex) {
  // 执行迁移的逻辑：创建users表
  return knex.schema.createTable('users', function(table) {
    table.increments('id').primary(); // 自增主键
    table.string('email').unique().notNullable(); // 唯一非空邮箱
    table.string('password_hash').notNullable(); // 密码哈希字段
    table.timestamp('created_at').defaultTo(knex.fn.now()); // 创建时间
    table.timestamp('updated_at').defaultTo(knex.fn.now()); // 更新时间
  });
};

exports.down = function(knex) {
  // 回滚迁移的逻辑：删除users表
  return knex.schema.dropTable('users');
};

4. 运行/回滚迁移 #

• 运行所有未执行的迁移：

npx knex migrate:latest

• 回滚最近一次迁移：

npx knex migrate:rollback

• 查看迁移状态（哪些已执行，哪些未执行）：

npx knex migrate:status

5. 和Sails集成的关键配置 #

为了避免Waterline的自动迁移和Knex的迁移冲突，需要修改Sails的模型配置，把Waterline的迁移模式设为safe：
打开config/models.js，修改migrate选项：

module.exports.models = {
  migrate: 'safe', // 禁止Waterline自动修改数据库结构
  // 其他模型配置...
};

这样就完全由Knex来管控数据库结构的变更了。

6. 在Sails中使用Knex查询（可选） #

如果需要在Sails的控制器/服务中用Knex执行查询，可以封装一个Knex服务：
创建api/services/KnexService.js：

const knexConfig = require('../../knexfile')[sails.config.environment];
const knex = require('knex')(knexConfig);

module.exports = {
  getInstance: () => knex,
  // 可以封装常用查询方法，比如获取用户列表
  getUsers: async () => {
    return knex('users').select('id', 'email');
  }
};

然后在控制器中使用：

module.exports = {
  async listUsers(req, res) {
    try {
      const users = await KnexService.getUsers();
      return res.ok(users);
    } catch (err) {
      return res.serverError(err);
    }
  }
};

这样就完成了Knex和Sails的集成，用Knex来灵活管理数据库迁移，同时可以继续使用Waterline处理其他ORM操作，或者完全用Knex处理数据库逻辑。

内容的提问来源于stack exchange，提问作者Boris K