NestJS API连接Supabase PostgreSQL数据库时出现SCRAM签名缺失错误

我之前踩过这个坑，这个错误基本都是连接配置或者依赖版本的问题，给你几个亲测有效的排查和解决方向：

1. 检查并修正数据库连接配置 #

• 优先使用Supabase提供的完整数据库URL来配置TypeOrm，而不是手动拆分host、port、username这些参数。Supabase的数据库URL格式是postgres://[用户名]:[密码]@[主机地址]:[端口]/[数据库名]，直接用这个URL会自动包含SCRAM认证所需的所有参数，避免手动配置遗漏。
• 必须开启SSL连接！Supabase的PostgreSQL强制要求SSL，你需要在TypeOrm配置里添加SSL相关设置：

  ssl: {
    rejectUnauthorized: false // 本地开发时需要这个，因为Supabase用的是自签名证书；生产环境可以根据实际情况调整
  }
  

2. 更新相关依赖版本 #

• 确保你的pg包（Node.js连接PostgreSQL的核心驱动）是最新版本，旧版本的pg对SCRAM-SHA-256认证的支持有缺陷。执行命令更新：

  npm install pg@latest
  

• 同时检查@nestjs/typeorm和typeorm的版本兼容性，版本不匹配也可能导致认证流程异常，建议保持这两个包的版本同步更新。

3. 重置Supabase数据库密码 #

有时候密码里的特殊字符会在传输过程中被转义，导致SCRAM签名验证失败。你可以去Supabase控制台重置数据库密码，尽量使用不含特殊字符的密码，或者对特殊字符进行URL转义后再填入配置。

4. 确认Supabase数据库状态 #

登录Supabase控制台，检查你的数据库实例是否正常运行，有没有处于暂停、维护或者异常状态。偶尔数据库实例重启后，连接参数可能需要重新确认。

给你一个完整的TypeOrm配置示例（放在app.module.ts里）：

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

@Module({
  imports: [
    TypeOrmModule.forRoot({
      url: process.env.SUPABASE_DB_URL, // 建议从环境变量读取URL，避免硬编码敏感信息
      type: 'postgres',
      ssl: {
        rejectUnauthorized: false,
      },
      autoLoadEntities: true,
      synchronize: false, // 生产环境务必关闭这个选项，避免数据丢失
    }),
  ],
})
export class AppModule {}

备注：内容来源于stack exchange，提问作者bassaoudm