将Knex配置从SQLite适配到PostgreSQL的问题求助

问题场景 #

在Vercel部署基于Knex、Express的Node.js API时，因Vercel不支持SQLite，参照Vercel PostgreSQL快速入门文档迁移后，修改knexfile.js出现以下错误：

TypeError: conn.run is not a function at afterCreate (/var/task/knexfile.js:14:39)

原SQLite配置 #

const path = require('path');

module.exports = {
  development: {
    client: 'sqlite3',
    connection: {
      filename: path.resolve(__dirname, 'src', 'database', 'database.db'),
    },
    pool: {
      afterCreate: (conn, cb) => conn.run('PRAGMA foreign_keys = ON', cb),
    },
    migrations: {
      directory: path.resolve(
        __dirname,
        'src',
        'database',
        'knex',
        'migrations'
      ),
    },
    useNullAsDefault: true,
  },
};

错误原因 #

1. conn.run是SQLite驱动专属API，PostgreSQL连接对象无此方法
2. PostgreSQL默认已开启外键约束，无需执行PRAGMA foreign_keys = ON语句

修正后的PostgreSQL配置 #

const path = require('path');

module.exports = {
  development: {
    client: 'pg',
    connection: {
      host: process.env.POSTGRES_HOST,
      user: process.env.POSTGRES_USER,
      password: process.env.POSTGRES_PASSWORD,
      database: process.env.POSTGRES_DATABASE,
      ssl: { rejectUnauthorized: false },
    },
    // 移除PostgreSQL不需要的afterCreate配置
    migrations: {
      directory: path.resolve(
        __dirname,
        'src',
        'database',
        'knex',
        'migrations'
      ),
    },
    // PostgreSQL不推荐useNullAsDefault，建议移除；若需兼容旧逻辑可保留
    // useNullAsDefault: true,
  },
};

额外注意事项 #

• 安装PostgreSQL驱动：执行npm install pg或yarn add pg
• 环境变量配置：Vercel会自动为PostgreSQL数据库注入POSTGRES_HOST、POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DATABASE变量；本地开发需在项目根目录创建.env文件手动配置
• 迁移文件适配：
  • SQLite的AUTOINCREMENT对应PostgreSQL的SERIAL或GENERATED AS IDENTITY
  • 数据类型差异：SQLite的TEXT对应PostgreSQL的VARCHAR/TEXT，INTEGER对应INT等
• 部署时执行迁移：在Vercel构建命令中添加knex migrate:latest，或在package.json的scripts中配置"build": "knex migrate:latest && node your-build-script.js"

内容的提问来源于stack exchange，提问作者Christian Henrique