本地NestJS应用无法连接Docker容器中的PostgreSQL数据库

错误信息 #

ERROR [TypeOrmModule] Unable to connect to the database. Retrying (2)...
    error: ������������ "admin" �� ������ �������� ����������� (�� ������)
        at Parser.parseErrorMessage (E:\Programming\Nodejs\LandPro\sportmaster\sportmaster_bitbucket\node_modules\pg-protocol\src\parser.ts:369:69)

（注：乱码实际含义为角色"admin"不存在，因终端编码不兼容导致）

环境与配置 #

操作流程 #

• 执行docker-compose up -d成功创建PostgreSQL容器，目标数据库已生成
• 本地启动nest start时无法连接数据库

相关配置 #

docker-compose.yml

version: '3.8'

services:
  db:
    container_name: sportmaster
    image: postgres:14.4
    restart: always
    environment:
      - POSTGRES_USER=${TYPEORM_USERNAME}
      - POSTGRES_PASSWORD=${TYPEORM_PASSWORD}
      - POSTGRES_DB=${TYPEORM_DATABASE}
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    ports:
      - ${TYPEORM_PORT}:${TYPEORM_PORT}

.env文件

TYPEORM_USERNAME=admin
TYPEORM_PASSWORD=admin
TYPEORM_DATABASE=sportmasterDB
TYPEORM_PORT=5432

TypeOrm配置

const ormconfig: TypeOrmModuleOptions = {
  type: 'postgres',
  username: process.env.TYPEORM_USERNAME,
  password: process.env.TYPEORM_PASSWORD,
  database: process.env.TYPEORM_DATABASE,
  host: 'localhost',
  port: 5432,
  logging: false,
  entities: [
    Order,
  ],
  synchronize: true,
  autoLoadEntities: true,
};

export default ormconfig;

容器状态（docker-compose ps输出）

排查与解决方案 #

核心原因 #

Docker容器初始化时，环境变量未正确加载，导致PostgreSQL未创建admin用户，而是使用了默认的postgres用户。

修复步骤 #

1. 删除现有数据卷（PostgreSQL初始化仅在第一次启动时执行，数据卷会保留旧配置）：

   docker-compose down -v
   

2. 验证.env文件加载：检查容器环境变量是否正确读取.env配置：

   docker exec sportmaster printenv POSTGRES_USER
   

   若输出不是admin，需确认：
   • .env文件与docker-compose.yml在同一目录
   • .env文件格式无多余空格、引号
3. 重新启动容器：

   docker-compose up -d
   

4. 验证用户存在：进入容器执行SQL查询，确认用户创建成功：

   docker exec -it sportmaster psql -U admin -d sportmasterDB
   

   成功进入后，重启NestJS应用即可正常连接。

临时测试方案 #

若不想删除数据卷，可临时修改TypeOrm配置为PostgreSQL默认值验证连接：

username: 'postgres',
password: 'postgres',

若连接成功，即可确认是初始化时用户未创建的问题。

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