使用PostgreSQL Docker镜像时无法连接NestJS的TypeORM模块数据库

可能的问题及对应解决方法： #

• 容器网络访问问题
  你配置里用localhost作为数据库host，但如果NestJS应用在宿主机运行、PostgreSQL在Docker容器内，Windows/macOS环境下可将host改为host.docker.internal；Linux环境下换成宿主机内网IP（如192.168.x.x），或者给Docker容器配置固定IP。
  原因：Docker容器的localhost指向容器自身，宿主机与容器属于不同网络空间，直接用localhost无法连通。

• 目标数据库未创建
  通过pgadmin登录数据库后，确认testDb数据库是否存在，若不存在需手动创建。

• 依赖包缺失
  确保已安装PostgreSQL驱动包，执行命令：

  npm install pg --save
  

  TypeORM连接PostgreSQL必须依赖该包，未安装会直接触发连接报错。

• 端口映射验证
  检查PostgreSQL容器启动命令是否包含端口映射参数-p 5432:5432，可通过docker ps查看容器端口映射状态，确认宿主机5432端口已正确映射到容器的5432端口。

• TypeORM版本适配问题
  若使用TypeORM 0.3.x版本，配置项有变更：autoLoadEntities需替换为entities数组（如entities: ['dist/**/*.entity{.ts,.js}']），同时确保type字段为小写'postgres'。可查看package.json中TypeORM版本，调整配置以匹配版本要求。

修改后的示例配置（以host.docker.internal为例）： #

@Module({
  imports: [
    TyreDetailsModule,
    TypeOrmModule.forRoot({
      type: 'postgres',
      host: 'host.docker.internal',
      port: 5432,
      username: 'postgres',
      password: 'postgres',
      database: 'testDb',
      autoLoadEntities: true,
      synchronize: true,
    }),
  ],
})

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