node-pg-migrate未读取自定义数据库名，默认使用PC用户名问题求助

可能原因 #

• node-pg-migrate未正确读取.env中配置的数据库名称，连接参数构建逻辑出错
• 迁移配置文件未正确引用环境变量里的DB_NAME字段
• Postgres客户端默认行为：当未明确指定数据库名时，会自动使用当前操作系统用户名作为默认数据库名，说明你的连接配置里确实没传入正确的DB_NAME

解决步骤 #

1. 检查迁移配置文件 #

确保migrations/config.js（或自定义配置文件）正确读取环境变量并配置连接参数：

require('dotenv').config();

module.exports = {
  development: {
    client: 'postgresql',
    connection: {
      database: process.env.DB_NAME,
      user: process.env.DB_USER,
      password: process.env.DB_PASSWORD,
      host: process.env.DB_HOST || 'localhost',
      port: process.env.DB_PORT || 5432
    },
    migrations: {
      directory: './migrations'
    }
  }
};

必须确保已安装dotenv依赖，且配置里的database字段确实指向process.env.DB_NAME

2. 命令行直接指定连接参数 #

如果配置文件仍有问题，执行迁移命令时直接指定数据库信息：

npx node-pg-migrate up --dbname=你的目标数据库名 --dbuser=数据库用户名 --dbpass=密码 --dbhost=localhost

或者用完整的Postgres连接URL：

npx node-pg-migrate up --url=postgres://用户名:密码@localhost:5432/你的目标数据库名

3. 验证环境变量读取情况 #

在配置文件中添加日志，确认process.env.DB_NAME的实际值：

console.log('当前读取的数据库名:', process.env.DB_NAME);

执行迁移前先运行这个配置文件，检查输出是否和你预期的一致，排除环境变量加载失败的问题。

4. 检查package.json的脚本命令 #

如果通过package.json的scripts执行迁移，确保脚本没有覆盖或未正确传递数据库配置：
错误示例：

"scripts": {
  "migrate": "node-pg-migrate up"
}

正确写法（需传递环境变量）：

"scripts": {
  "migrate": "node-pg-migrate up --dbname=$DB_NAME"
}

Windows系统请替换为%DB_NAME%

额外排查项 #

• 检查.env文件的变量名是否拼写正确，比如是否把DB_NAME写成了DB_NAM
• 用psql命令验证目标数据库存在：psql -U 数据库用户名 -d 你的目标数据库名，能正常登录则说明数据库没问题

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