Prisma执行migrate dev命令卡住，如何完成SuperBase数据库迁移？

针对你在Twitter-Clone项目中遇到的Prisma迁移命令卡住问题，以下是具体排查和解决步骤：

1. 检查SuperBase数据库的网络访问权限 #

• 登录SuperBase控制台，进入「Database」→「Settings」→「IP Allowlist」，确认你的本地/服务器IP已添加到允许列表中。测试阶段可暂时设置为0.0.0.0/0（注意生产环境不要这么配置）。
• 用telnet测试端口连通性：telnet <你的SuperBase数据库主机> 5432，如果无法连通，排查本地防火墙或网络服务商是否拦截了5432端口。

2. 验证Prisma Schema语法正确性 #

• 检查schema.prisma中的User模型是否存在语法错误，比如字段类型不匹配、缺少必填标识。示例正确的User模型：

  model User {
    id        String   @id @default(cuid())
    username  String   @unique
    email     String   @unique
    createdAt DateTime @default(now())
    updatedAt DateTime @updatedAt
  }
  

• 执行npx prisma validate命令验证schema，修复所有报错后再重新执行迁移。

3. 完善DATABASE_URL配置 #

• SuperBase数据库强制要求SSL连接，确保你的.env文件中DATABASE_URL包含sslmode=require参数，格式如下：

  DATABASE_URL="postgresql://postgres:<你的数据库密码>@<你的数据库主机>:5432/postgres?sslmode=require"
  

• 若密码包含特殊字符（如@、#），需进行URL编码（比如@替换为%40）。

4. 排查版本兼容性问题 #

• 确认Prisma版本与SuperBase使用的PostgreSQL版本兼容，建议升级到Prisma最新稳定版：npm install prisma@latest，之后重新执行迁移命令。

5. 清除本地缓存与阻塞进程 #

• 杀掉所有Prisma相关进程，删除prisma/migrations目录（若已存在），再重新运行迁移命令。
• 执行npm cache clean --force清除npm缓存，随后重新安装依赖：npm install。

内容的提问来源于stack exchange，提问作者SAURAV PRATAP SINGH