Prisma对接Supabase初始迁移报错：用户或db_name格式无效

近期将PostgreSQL托管从NeonDB迁移至Supabase，新建项目后执行以下命令：

npx prisma generate
npx prisma migrate dev --name init

遇到两个核心错误：

1. Prisma抛出认证错误：

Error: FATAL: Authentication error, reason: "Invalid format for user or db_name"
   0: schema_core::state::DevDiagnostic
             at schema-engine/core/src/state.rs:276

2. Supabase日志显示：

relation "_prisma_migrations" does not exist

对应的查询语句为：

SELECT "id", "checksum", "finished_at", "migration_name", "logs", "rolled_back_at", "started_at", "applied_steps_count"
FROM "_prisma_migrations"
ORDER BY "started_at" ASC

当前使用的schema.prisma和.env配置如下：
schema.prisma

generator client {
    provider = "prisma-client-js"
}

datasource db {
    provider  = "postgresql"
    directUrl = env("DIRECT_URL")
    url       = env("DATABASE_URL")
}

.env

# Connect to Supabase via connection pooling with Supavisor.
DATABASE_URL="postgresql://postgres.jdjgwzijrvzkmobplscq:[ALPHANUMERIC_PASS]@aws-0-eu-west-3.pooler.supabase.com:6543/postgres?pgbouncer=true"

# Direct connection to the database. Used for migrations.
DIRECT_URL="postgresql://postgres.jdjgwzijrvzkmobplscq:[ALPHANUMERIC_PASS]@aws-0-eu-west-3.pooler.supabase.com:5432/postgres"

解决步骤 #

1. 修正数据库连接串的用户名格式 #

Supabase的PostgreSQL用户名应为纯postgres，而非带项目ID后缀的postgres.<project-id>。PostgreSQL无法识别带点的未加引号用户名，这是导致认证错误的核心原因。

修改.env中的连接串：

# 池化连接（应用使用）
DATABASE_URL="postgresql://postgres:[ALPHANUMERIC_PASS]@aws-0-eu-west-3.pooler.supabase.com:6543/postgres?pgbouncer=true"

# 直接连接（迁移使用）
DIRECT_URL="postgresql://postgres:[ALPHANUMERIC_PASS]@aws-0-eu-west-3.pooler.supabase.com:5432/postgres"

2. 确保迁移使用无池化的直接连接 #

Prisma迁移需要执行DDL操作，而pgBouncer（Supabase的连接池）在事务模式下不支持DDL。因此必须确保DIRECT_URL使用5432端口，且不带pgbouncer=true参数，让迁移直接连接数据库。

3. 重置Prisma迁移状态（若有残留） #

如果之前的错误导致本地迁移状态与数据库不一致，执行以下操作：

• 删除本地prisma/migrations目录
• 运行npx prisma migrate reset（注意：该命令会清空数据库所有数据，仅适用于测试环境）
• 重新执行npx prisma migrate dev --name init

4. 验证连接有效性 #

用psql工具测试直接连接是否正常：

psql "postgresql://postgres:[ALPHANUMERIC_PASS]@aws-0-eu-west-3.pooler.supabase.com:5432/postgres"

若能成功进入psql命令行，说明连接配置正确，再重新运行Prisma命令。

5. 确认数据库用户权限 #

默认情况下Supabase的postgres用户是超级用户，拥有创建表和执行DDL的权限。若权限异常，可在Supabase控制台的「数据库」→「角色」中检查postgres角色的权限设置。

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