Knexfile无法读取环境变量？Node/Express+Docker项目问题

嘿，我之前在做Docker+Knex的Node服务时也踩过类似的坑！看你说应用能正确读取环境变量，但Knex配置这里好像有点小问题（你贴的代码里user: pro...应该是输入截断了吧？正确应该是user: process.env.DATABASE_USER对吧？），我来分享几个亲测有效的解决思路：

1. 先确认Knex能读到环境变量 #

有时候Node进程启动顺序的问题，会导致Knex加载时环境变量还没就绪。你可以在knexfile最顶部加一行调试打印，看看Knex视角下的变量值：

// 调试用，上线前删掉就行
console.log("Knex 加载时的数据库用户:", process.env.DATABASE_USER);

module.exports = {
  development: {
    client: 'pg',
    connection: {
      host: process.env.DATABASE_HOST,
      port: process.env.DATABASE_PORT,
      user: process.env.DATABASE_USER,
      password: process.env.DATABASE_PASSWORD,
      database: process.env.DATABASE_NAME
    },
    migrations: { directory: './migrations' },
    seeds: { directory: './seeds' }
  }
};

如果这行打印出正确的值，那变量本身没问题；要是输出undefined，就得检查docker-compose里的env_file路径是否正确——比如你的.env文件是不是放在docker-compose.yml的同级目录？路径要写对：

services:
  your-node-app:
    build: .
    env_file:
      - ./.env # 确保这个路径是相对于docker-compose.yml的
    ports:
      - "3000:3000"

2. 端口号必须转成数字！ #

这个细节我之前卡了超久！process.env里的所有变量都是字符串类型，但Knex的port字段要求是数字。直接用字符串会导致数据库连接失败，所以一定要手动转：

connection: {
  host: process.env.DATABASE_HOST,
  port: parseInt(process.env.DATABASE_PORT, 10), // 转成整数，第二个参数10是十进制
  user: process.env.DATABASE_USER,
  password: process.env.DATABASE_PASSWORD,
  database: process.env.DATABASE_NAME
}

3. 别依赖depends_on的顺序——加健康检查 #

就算在docker-compose里给应用加了depends_on: db，也不代表数据库已经完全启动好了（比如PostgreSQL需要初始化用户和数据库）。给数据库服务加健康检查，确保应用只在数据库就绪后才启动：

services:
  db:
    image: postgres:15
    env_file: ./.env
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DATABASE_USER} -d ${DATABASE_NAME}"]
      interval: 5s
      timeout: 5s
      retries: 5
  your-node-app:
    build: .
    env_file: ./.env
    ports:
      - "3000:3000"
    depends_on:
      db:
        condition: service_healthy # 等待数据库健康检查通过

4. 换用连接URL格式（终极方案） #

如果上面的方法都不行，试试直接用PostgreSQL的连接URL，把所有变量拼在一起。Knex会自动解析这个URL，避开单个字段的类型或加载问题：

module.exports = {
  development: {
    client: 'pg',
    connection: `postgresql://${process.env.DATABASE_USER}:${process.env.DATABASE_PASSWORD}@${process.env.DATABASE_HOST}:${process.env.DATABASE_PORT}/${process.env.DATABASE_NAME}`,
    migrations: { directory: './migrations' },
    seeds: { directory: './seeds' }
  }
};

我在好几个项目里都用这种方式，稳定性拉满！

最后别忘了重启容器让配置生效：docker-compose down && docker-compose up --build

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