如何使用pg库连接Docker中运行的PostgreSQL与NodeJS服务器？

第一步：修复模块导入错误 #

终端报错TypeError: Cannot read properties of undefined (reading 'query')的直接原因是导入方式不匹配：

• db.js中你通过module.exports = pool做了默认导出，但在tasks.routes.js里误用了命名导入const { pool } = require('../db')，导致pool变量为undefined。

修改routes/tasks.routes.js的导入代码：

const { Router } = require('express');
// 去掉解构语法，直接导入默认导出的pool
const pool = require('../db')

第二步：修复Docker PostgreSQL与本地Node服务的连接配置 #

你当前使用容器内部IP172.17.0.2作为host，这个IP会在容器重启后变化，且本地服务访问容器内部IP存在网络限制，更可靠的方案是端口映射+localhost访问：

1. 确保PostgreSQL容器已配置端口映射 #

启动Docker PostgreSQL容器时，必须将容器的5432端口映射到本地端口，命令示例：

docker run -d \
  --name my-own-postgres \
  -p 5432:5432 \  # 核心：将容器端口映射到本地
  -e POSTGRES_PASSWORD=somepass \
  postgres

如果已启动容器但未配置端口映射，需先停止并删除容器，再重新启动：

docker stop my-own-postgres
docker rm my-own-postgres
# 执行上述带端口映射的启动命令

2. 更新数据库连接参数 #

修改db.js中的host为localhost（端口映射后，本地可通过localhost访问容器内的PostgreSQL）：

const { Pool } = require('pg')

const pool = new Pool({
    user: 'postgres',
    password: 'somepass',
    host: 'localhost',  // 替换为localhost
    port: 5432,
    database: 'tasksdb'
})

module.exports = pool;

第三步：验证连接 #

重启Node.js服务，访问http://localhost:4001/tasks，此时应能成功执行SELECT NOW()并返回结果。

额外优化：用Docker Compose管理服务（可选） #

如果需要长期维护，建议用Docker Compose统一管理PostgreSQL和PgAdmin，避免手动处理容器与网络：
创建docker-compose.yml文件：

version: '3.8'
services:
  postgres:
    image: postgres
    container_name: my-own-postgres
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: somepass
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化数据库数据

  pgadmin:
    image: dpage/pgadmin4
    container_name: my-own-pgadmin
    ports:
      - "82:80"
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@example.com
      PGADMIN_DEFAULT_PASSWORD: admin
    volumes:
      - pgadmin_data:/var/lib/pgadmin

volumes:
  postgres_data:
  pgadmin_data:

启动服务：

docker-compose up -d

此时PgAdmin连接PostgreSQL时，主机名填postgres（Docker Compose内部服务别名）；本地Node服务连接时依然用localhost:5432。

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