TypeORM连接Docker部署的PostgreSQL提示pg包未安装错误如何解决

1. 修复TypeORM无法识别pg驱动问题 #

当前报错提示找不到pg包但package.json已安装，属于TypeORM驱动加载常见异常，按以下步骤处理：

• 完整清理依赖后重装：删除项目根目录的node_modules文件夹、package-lock.json或yarn.lock文件，执行npm install重新安装所有依赖，避免单独安装pg导致的版本冲突
• 强制指定pg驱动：如果使用TypeScript且tsconfig配置为ES模块规范，在数据库连接配置中添加driver: require('pg')，或在代码头部导入import * as pg from 'pg'后在连接配置中添加extra: { pg }，强制TypeORM加载已安装的pg包
• 校验版本兼容性：pg@8.7.1需要搭配TypeORM 0.2.37及以上版本，若TypeORM版本过低，执行npm install typeorm@latest --save升级到匹配版本

2. 修复数据库连接配置不匹配问题 #

你的docker-compose中PostgreSQL的账号密码从环境变量读取，和连接代码中的写死值不一致是常见连接失败原因：

• 查看项目根目录的.env文件，确认POSTGRES_USER、POSTGRES_PASSWORD的实际取值，将连接配置中的username、password字段改为和.env一致的内容
• 执行docker ps确认postgres容器处于运行状态，也可访问localhost:8080打开adminer管理页面，输入账号密码测试能否正常登录访问目标库
• 执行lsof -i:5432检查5432端口是否被其他本地PostgreSQL服务占用，若存在占用可修改docker-compose的端口映射为5433:5432，同步修改连接配置中的port为5433即可

3. 快速排查验证 #

可运行以下测试脚本确认pg本身和数据库网络是否正常：

const { Client } = require('pg')
const client = new Client({
  host: 'localhost',
  port: 5432,
  user: '替换为.env中的POSTGRES_USER值',
  password: '替换为.env中的POSTGRES_PASSWORD值',
  database: 'alex'
})

client.connect()
  .then(() => console.log('数据库连接正常'))
  .catch(err => console.error('连接错误：', err))
  .finally(() => client.end())

如果脚本输出连接成功，说明问题仅出在TypeORM驱动加载环节，按第一部分方案处理即可。

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