NestJS连接Docker中PostgreSQL提示role不存在问题求助

问题分析 #

从错误日志和你的操作来看，核心矛盾点：

• Docker容器内部能正常用test角色连接数据库，但本地（包括NestJS应用）无法连接，提示角色不存在或数据库不存在
• 初始化脚本的执行时机、角色创建逻辑，以及PostgreSQL启动后的就绪状态验证，是关键问题所在

解决方案步骤 #

1. 修正初始化SQL脚本 #

把角色创建移到全局层级，避免切换数据库后创建导致的权限/全局可见性问题，同时指定数据库所有者为test：

-- 先创建全局登录角色
CREATE ROLE "test" LOGIN PASSWORD 'whatever';
-- 创建数据库并直接指定所有者，自动赋予该角色数据库操作权限
CREATE DATABASE mydatabase OWNER "test";

-- 切换到目标数据库创建表
\c mydatabase
CREATE TABLE video_subs (
  wallet VARCHAR(42),
  video TEXT,
  PRIMARY KEY (wallet, video)
);

INSERT INTO video_subs(wallet, video) VALUES 
('0x12345', 'video1'),
('0x23456', 'video2'),
('0x34567', 'video3'),
('0x45678', 'video4'),
('0x56789', 'video2'),
('0x67890', 'video2'),
('0x78901', 'video2'),
('0x89012', 'video3'),
('0x90123', 'video3'),
('0x01234', 'video4'),
('0x12345', 'video2'),
('0x23456', 'video1'),
('0x34567', 'video1'),
('0x45678', 'video2'),
('0x56789', 'video1'),
('0x67890', 'video1'),
('0x78901', 'video4'),
('0x89012', 'video2'),
('0x90123', 'video2'),
('0x01234', 'video2');

2. 调整Docker启动脚本，确保PostgreSQL完全初始化 #

原脚本的sleep 2不足以覆盖首次初始化的耗时，换成循环等待服务就绪：

source /Users/name/factor_app/app/server/.env
docker rm -f my_postgres;
docker run --name my_postgres -e POSTGRES_PASSWORD=$DB_PASSWORD -p 5432:5432 -v /Users/name/factor_app/app/server/database/init.sql:/docker-entrypoint-initdb.d/setup.sql -d postgres

# 循环等待PostgreSQL服务就绪，避免提前执行连接操作
until docker exec my_postgres pg_isready -U postgres; do
  echo "Waiting for PostgreSQL to start..."
  sleep 1
done

# 确认初始化完成后再连接
docker exec -it -e PGPASSWORD='whatever' my_postgres psql -h localhost -U test -d mydatabase

3. 优化TypeORM连接配置 #

增加重试次数和间隔，给PostgreSQL足够的初始化时间：

imports: [
  TypeOrmModule.forRoot({
      type: 'postgres',
      host: 'localhost', // 本地运行NestJS用localhost即可，容器已映射端口
      port: 5432,
      username: 'test',
      password: 'whatever',
      database: 'mydatabase',
      entities: ['src/entities/*.entity{.ts,.js}'],
      synchronize: true,
      retryAttempts: 20, // 增加重试次数
      retryDelay: 1000, // 每次重试间隔1秒
  }),
  // 其他模块...
],

4. 验证初始化结果 #

如果仍有问题，进入容器检查角色和数据库是否存在：

# 进入容器以postgres身份登录
docker exec -it my_postgres psql -U postgres
# 执行以下SQL验证
SELECT rolname FROM pg_roles WHERE rolname = 'test';
SELECT datname FROM pg_database WHERE datname = 'mydatabase';

如果查询无结果，检查挂载的初始化脚本路径是否正确，确保/Users/name/factor_app/app/server/database/init.sql文件存在且路径无误。

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