Drizzle ORM 连接 Supabase 数据库时出现 "Pulling schema" 卡住问题的分析与解决方案

问题描述

在使用 Drizzle ORM 和 Drizzle Kit 连接 Supabase PostgreSQL 数据库时，许多开发者遇到了一个常见问题：当执行 drizzle-kit push 命令时，进程会在"Pulling schema from database..."阶段卡住，无法继续执行。这个问题在社区中被广泛报告，影响了多个版本的使用体验。

问题表现

开发者们报告的主要症状包括：

1. 命令执行后长时间停留在"Pulling schema from database..."状态
2. 使用 --verbose 参数时可能显示关于"dialect"未定义的 Zod 验证错误
3. 问题似乎特别出现在连接 Supabase 数据库时

根本原因分析

经过社区成员的深入探索，发现问题可能与 Supabase 的连接模式有关。Supabase 提供了两种连接模式：

1. 连接池模式（默认端口6543）
2. 直接会话模式（标准PostgreSQL端口5432）

当使用连接池模式（6543端口）时，Drizzle Kit 似乎无法正确识别数据库方言(dialect)，导致 schema 拉取过程失败。这可能是由于连接池中间件对某些元数据查询请求的处理方式与 Drizzle Kit 的预期不符。

解决方案

目前社区验证有效的解决方案是：

1. 临时切换连接模式： 将连接字符串中的端口从默认的6543改为5432，使用 Supabase 的直接会话模式。例如：

   postgres://postgres.[project-ref]:[password]@[host].pooler.supabase.com:5432/postgres
   

   完成数据库操作后，可以切换回连接池模式。

2. 数据库重置方案： 如果切换端口无效，部分开发者报告可以通过以下步骤解决：

   • 导出现有数据为CSV
   • 完全重置数据库（删除所有表）
   • 重新执行 drizzle-kit push
   • 重新导入数据

最佳实践建议

1. 开发环境配置： 建议在开发环境中使用5432端口的直接连接，避免连接池可能带来的兼容性问题。

2. 生产环境考量： 生产环境中如需使用连接池，应在完成 schema 迁移后再切换回连接池模式。

3. 版本兼容性： 虽然问题在多个版本中持续存在，建议保持 Drizzle ORM 和 Drizzle Kit 版本同步更新。

技术细节补充

PostgreSQL 连接池与直接连接的主要区别在于：

• 连接池模式：中间件管理连接复用，适合高并发场景
• 直接连接：客户端与数据库直接通信，元数据查询更可靠

Drizzle Kit 在进行 schema 迁移时需要查询数据库的元数据信息（如表结构、列类型等），这些查询在通过连接池时可能出现信息丢失或格式不符的情况，导致工具无法正确解析数据库方言。

总结

Drizzle ORM 与 Supabase 的集成问题主要源于连接模式的选择。通过理解底层连接机制并采用适当的变通方案，开发者可以顺利完成数据库 schema 的迁移工作。建议开发团队关注此问题的官方修复进展，同时可以在开发流程中采用上述解决方案作为临时措施。