Next.js13+Knex.js执行migrate:make命令时遇路径参数为空错误

核心原因 #

这个错误通常是Knex无法正确识别迁移文件的存储目录，要么是knexfile.ts中的路径配置错误，要么是执行命令时没有正确指定配置文件路径。

解决步骤 #

1. 修正knexfile.ts中的路径配置 #

确保迁移和种子文件的目录路径配置正确，避免相对路径导致的解析问题：

• 如果使用CommonJS模块：

  const path = require('path');
  
  module.exports = {
    development: {
      client: 'postgresql',
      connection: {
        // 你的PostgreSQL连接信息
        host: process.env.DB_HOST,
        database: process.env.DB_NAME,
        user: process.env.DB_USER,
        password: process.env.DB_PASSWORD
      },
      migrations: {
        // 使用绝对路径指向migrations文件夹
        directory: path.resolve(__dirname, './migrations')
      },
      seeds: {
        directory: path.resolve(__dirname, './seeds')
      }
    }
  };
  

• 如果使用ES模块（Next.js 13默认可能启用ESM）：

  import { fileURLToPath } from 'url';
  import { dirname, resolve } from 'path';
  
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = dirname(__filename);
  
  export default {
    development: {
      client: 'postgresql',
      connection: {
        // 你的PostgreSQL连接信息
      },
      migrations: {
        directory: resolve(__dirname, './migrations')
      },
      seeds: {
        directory: resolve(__dirname, './seeds')
      }
    }
  };
  

2. 通过package.json脚本执行迁移命令 #

不要直接使用npx knex migrate:make，而是利用package.json中配置的脚本，确保命令能正确找到knexfile.ts：

1. 调整package.json的scripts字段：

   "scripts": {
     "migrate:make": "knex migrate:make --knexfile ./config/database/Knexfile.ts",
     "migrate:latest": "knex migrate:latest --knexfile ./config/database/Knexfile.ts",
     "seed:run": "knex seed:run --knexfile ./config/database/Knexfile.ts"
   }
   

2. 执行创建迁移文件的命令：

   npm run migrate:make create_test_table
   

3. 确保Knex能解析TypeScript配置文件 #

如果你的项目使用TypeScript，需要安装ts-node来让Knex正确解析.ts格式的配置文件：

1. 安装依赖：

   npm install ts-node --save-dev
   

2. 修改package.json中的脚本，加入ts-node前缀：

   "scripts": {
     "migrate:make": "ts-node ./node_modules/knex/bin/cli.js migrate:make --knexfile ./config/database/Knexfile.ts"
   }
   

4. 验证路径有效性 #

可以在knexfile.ts中添加日志输出，确认路径是否指向正确的文件夹：

// 在ES模块的knexfile中添加
console.log('Migrations directory path:', resolve(__dirname, './migrations'));

执行迁移命令时查看控制台输出，确认路径是否存在且正确。

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