Drizzle ORM 中 drizzle-kit 的字段名大小写保留问题解析

问题背景

在使用 Drizzle ORM 的 drizzle-kit 工具进行数据库内省(introspect)时，开发者遇到了一个关于字段名大小写保留的问题。具体表现为：在升级到 drizzle-kit 0.24.0 版本后，内省生成的模型代码会自动将数据库字段名转换为驼峰式命名，而开发者期望保留原始的大小写格式。

问题表现

当开发者使用 drizzle-kit 进行数据库内省时，生成的模型代码会将类似 finished_at 这样的数据库字段名转换为 finishedAt 的驼峰命名形式。这与开发者现有代码中期望的原始命名格式不符，导致兼容性问题。

解决方案探索

Drizzle ORM 官方文档中确实提供了 introspect.casing 配置选项，可以设置为 'preserve' 来保持原始大小写格式。开发者尝试了以下两种方式：

1. 配置文件方式：

import { defineConfig } from 'drizzle-kit';

export default defineConfig({
  // ...其他配置
  introspect: {
    casing: 'preserve',
  },
});

2. 命令行参数方式：

yarn drizzle-kit introspect --introspect-casing=preserve

然而，在 0.24.0 版本中，这两种方式都未能生效，生成的代码仍然使用驼峰命名。

临时解决方案

开发者通过降级到 drizzle-kit 0.22.8 版本暂时解决了这个问题，因为在该版本中，字段名大小写能够被正确保留。

官方修复

Drizzle ORM 团队在后续的 0.24.1 版本中修复了这个问题。根据测试反馈，在 0.24.2 版本中，introspect.casing 配置已经能够正常工作，可以正确保留字段名的原始大小写格式。

技术建议

对于使用 Drizzle ORM 的开发者，在处理数据库内省时应注意：

1. 始终检查生成代码的字段名格式是否符合预期
2. 在升级 drizzle-kit 版本时，进行充分的测试验证
3. 了解并合理使用 introspect.casing 配置选项
4. 遇到类似问题时，可以查阅项目 issue 或考虑暂时降级

总结

数据库 ORM 工具中的字段名映射问题是一个常见的兼容性挑战。Drizzle ORM 通过提供灵活的配置选项来解决这个问题，但在实现过程中可能会出现短暂的回归问题。开发者应该关注工具版本更新日志，并在生产环境升级前进行充分测试。