如何在.env与.env.local中仅配置一次密码，避免重复设置PGPASSWORD和POSTGRES_PASSWORD？

我希望在.env和.env.local文件中仅指定一次密码，而非同时设置PGPASSWORD和POSTGRES_PASSWORD，具体背景如下：

• Docker的Postgres镜像需要POSTGRES_PASSWORD环境变量来创建带密码的数据库
• node-postgres需要PGPASSWORD环境变量，且两者密码必须一致
• 我用.env.local存储敏感密码，.env存储可纳入源码的通用环境变量

我的配置文件内容：

.env 文件 #

DB_USER=root
# DB_PASSWORD=<PASSWORD>
DB_DBNAME=qr_orders_db

PGUSER=${DB_USER}
PGPASSWORD=${DB_PASSWORD}
PGDATABASE=${DB_DBNAME}

POSTGRES_USER=${DB_USER}
POSTGRES_PASSWORD=${DB_PASSWORD}
POSTGRES_DB=${PGDATABASE}

.env.local 文件 #

DB_PASSWORD=root

Docker Compose 文件 #

services:
  db:
    image: postgres
    env_file:
      - .env
      - .env.local
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  pgdata:

执行docker compose up时出现错误：

WARN[0000] The "DB_PASSWORD" variable is not set. Defaulting to a blank string. 
...（重复警告）
db-1  | Error: Database is uninitialized and superuser password is not specified.
db-1 exited with code 1

若将.env.local放在.env之前，错误消失但仍存在大量相同警告。需解决：

1. 原配置为何无法运行？
2. 如何实现仅配置一次密码且无错误与警告？

原配置失败的原因 #

Docker Compose按顺序加载env文件，且加载每个文件时会立即解析其中的变量引用：

• 当先加载.env时，里面的PGPASSWORD=${DB_PASSWORD}和POSTGRES_PASSWORD=${DB_PASSWORD}会尝试引用未定义的DB_PASSWORD（此时.env.local还未加载），因此变量被默认设为空字符串。后续.env.local加载的DB_PASSWORD无法覆盖已解析完成的容器环境变量，导致Postgres容器拿到空密码，触发初始化错误。
• 若调换顺序先加载.env.local，虽然变量能正确解析，但Docker Compose在扫描.env文件时，仍会因初始环境中无DB_PASSWORD而抛出警告（即使后续文件会定义该变量）。

解决方案 #

方案一：给.env中的DB_PASSWORD设置空占位符 #

修改.env文件，去掉DB_PASSWORD的注释，设置为空值占位：

DB_USER=root
DB_PASSWORD=
DB_DBNAME=qr_orders_db

PGUSER=${DB_USER}
PGPASSWORD=${DB_PASSWORD}
PGDATABASE=${DB_DBNAME}

POSTGRES_USER=${DB_USER}
POSTGRES_PASSWORD=${DB_PASSWORD}
POSTGRES_DB=${PGDATABASE}

.env.local保持不变，Docker Compose的env_file顺序仍为.env在前、.env.local在后：

services:
  db:
    image: postgres
    env_file:
      - .env
      - .env.local
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  pgdata:

此方案中，.env加载时DB_PASSWORD已有定义（空值），不会触发警告；后续.env.local的DB_PASSWORD=root会覆盖空值，最终容器拿到的密码正确。

方案二：用Compose的environment字段统一传递变量 #

修改Docker Compose文件，通过environment字段直接定义Postgres容器所需变量，确保所有env文件加载完成后再解析变量引用：

services:
  db:
    image: postgres
    env_file:
      - .env
      - .env.local
    environment:
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=${DB_DBNAME}
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  pgdata:

同时修改.env文件，移除其中的Postgres镜像相关变量（交由Compose统一处理）：

DB_USER=root
# DB_PASSWORD=<PASSWORD>
DB_DBNAME=qr_orders_db

PGUSER=${DB_USER}
PGPASSWORD=${DB_PASSWORD}
PGDATABASE=${DB_DBNAME}

.env.local保持不变。此方案下，Compose会在所有env文件加载完成后解析变量，不会出现警告，且DB_PASSWORD仅在.env.local中定义一次。

额外说明 #

• 确保你的Node应用通过dotenv等工具加载.env和.env.local，即可自动解析PGPASSWORD=${DB_PASSWORD}为正确值，无需额外配置。
• 务必将.env.local加入.gitignore，防止敏感信息泄露。

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