Drizzle-ORM 中复合主键迁移问题的分析与解决

在数据库迁移过程中，复合主键的处理一直是一个需要特别注意的技术点。最近在 Drizzle-ORM 0.31.2 和 Drizzle-Kit 0.22.7 版本中发现了一个关于复合主键迁移的严重问题，这个问题会导致迁移过程失败。

问题本质

当开发者尝试运行包含复合主键的迁移时，系统会抛出错误。深入分析后发现，问题根源在于 drizzle-kit 的 bin.cjs 文件中处理复合主键删除的逻辑存在缺陷。

具体来说，在 prepareDeleteCompositePrimaryKeyPg 函数中，schema5 参数未被正确传递，导致后续构建表名时出现错误。原本应该形如 public.table 的表名被错误地构建为 .table，这显然不符合预期。

技术细节

在 PostgreSQL 中，表名通常由模式名(schema)和表名组成，格式为 schema.table。当模式名缺失时，系统无法正确识别表对象。这个错误特别容易出现在以下场景：

1. 使用默认的 public 模式但未显式指定
2. 迁移脚本中处理复合主键时
3. 执行删除复合主键的操作时

解决方案

Drizzle 团队在后续的 0.22.8 版本中修复了这个问题。修复的核心是确保在处理复合主键时正确传递和使用模式名参数。开发者只需升级到最新版本即可解决此问题。

最佳实践

为了避免类似问题，建议开发者：

1. 始终显式指定表所属的模式名
2. 在定义复合主键时，检查生成的迁移脚本
3. 保持 ORM 工具和迁移工具版本同步
4. 在复杂迁移前先进行测试

复合主键是数据库设计中常见的模式，正确处理它们的迁移对于保证数据完整性至关重要。通过理解这个问题的本质和解决方案，开发者可以更自信地在项目中使用 Drizzle-ORM 处理复杂的数据结构。