如何解决NestJS连接PostgreSQL时的‘role Stell不存在’错误？

问题背景 #

尝试使用NestJS连接PostgreSQL数据库，已在.env文件中配置了与Linux账户名称不同的PostgreSQL用户Stell，且已在PostgreSQL中创建该角色并赋予超级用户权限，但连接时仍报错role "Stell" does not exist，错误日志如下：

[Nest] 18553 - 01.05.2023, 22:07:19 ERROR [Exception Handler] role "Stell" does not exist
error: role "Stell" does not exist
in Parser.parser Error message (/home/Steel/Documents/WebStormProject/spotify/backend/node_modules/pg-protocol/src/parser.ts:369:69)
in Parser.handlePacket (/home/Steel/Documents/WebStormProject/spotify/backend/node_modules/pg-protocol/src/parser.ts:188:21)
in Parser.parse (/home/Steel/Documents/WebStormProject/spotify/backend/node_modules/pg-protocol/src/parser.ts:103:30)
in the socket. (/home/Steel/Documents/WebStormProject/spotify/backend/node_modules/pg-protocol/src/index.ts:7:48)
in Socket.emit (node:events:513:28)
in addChunk (node:internal/threads/readable:324:12)
in readableAddChunk (node:internal/streams/readable:297:9)
in the socket.Readable.push (node:internal/streams/readable:234:10)
when reading TCP.on Stream (node:internal/stream_base_commons:190:23)

当前typeorm.module.ts配置代码：

import { Module } from '@nestjs/common';
import { TypeOrmModule as NestTypeOrmModule } from '@nestjs/typeorm';

@Module({
    imports: [
        NestTypeOrmModule.forRoot({
            type: 'postgres',
            host: process.env.DB_HOST,
            port: Number(process.env.DB_PORT),
            username: process.env.DB_USERNAME,
            password: process.env.DB_PASSWORD,
            database: process.env.DB_DATABASE,
            entities: ['dist/entities/**/*.entity.js'],
            synchronize: true,
        }),
    ],
})
export class TypeOrmModule {}

修复方案 #

1. 核对角色名大小写一致性 #

PostgreSQL对角色名大小写敏感：

• 若创建角色时使用了双引号（如CREATE ROLE "Stell";），需确保.env文件中DB_USERNAME的值为Stell（大小写完全匹配）；
• 若创建角色时未加双引号，PostgreSQL会自动将角色名转为小写stell，此时.env里的DB_USERNAME必须写stell。

2. 确保环境变量正确加载 #

如果NestJS未读取到.env中的配置，会默认使用当前Linux账户尝试连接：

• 安装@nestjs/config模块：npm install @nestjs/config
• 在根模块app.module.ts中全局导入配置模块，确保环境变量全局可用：

  import { Module } from '@nestjs/common';
  import { ConfigModule } from '@nestjs/config';
  import { TypeOrmModule } from './typeorm.module';
  
  @Module({
    imports: [
      ConfigModule.forRoot({ isGlobal: true }),
      TypeOrmModule,
    ],
  })
  export class AppModule {}
  

• 可在typeorm.module.ts中临时添加日志，验证环境变量是否正确读取：

  console.log('当前数据库用户:', process.env.DB_USERNAME);
  

3. 验证PostgreSQL角色是否存在 #

登录PostgreSQL终端，执行以下SQL查询确认角色是否存在：

SELECT rolname FROM pg_roles WHERE rolname = 'Stell'; -- 注意大小写要与创建时一致

若查询结果为空，重新创建角色（需匹配大小写）：

CREATE ROLE "Stell" WITH SUPERUSER LOGIN PASSWORD '你的数据库密码';

4. 赋予角色数据库连接权限 #

确保Stell角色拥有目标数据库的连接权限：

GRANT CONNECT ON DATABASE "你的数据库名称" TO "Stell";

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