Drizzle ORM 与 Drizzle Kit 在 MySQL 类型处理中的注意事项

Drizzle ORM 是一个现代化的 TypeScript ORM 框架，而 Drizzle Kit 是其配套的工具集。在使用过程中，开发者可能会遇到一些关于 MySQL 数据类型处理的特殊情况，特别是在使用 drizzle-kit introspect 命令进行数据库模式自省时。

SMALLINT 类型导入问题

在早期版本的 Drizzle Kit 中，当数据库表包含 SMALLINT 类型字段时，自动生成的模式文件中会缺少对 smallint 类型的导入。这会导致 TypeScript 编译错误，因为代码中使用了未导入的类型。

解决方案是确保在生成的模式文件顶部包含正确的导入语句。例如：

import { mysqlTable, smallint } from "drizzle-orm/mysql-core"

这个问题已在 Drizzle Kit 0.28.0 版本中得到修复。但开发者需要注意，类似的类型导入问题可能也会出现在其他整数类型上，如 TINYINT。

DECIMAL UNSIGNED 处理问题

MySQL 中的 DECIMAL UNSIGNED 类型在 Drizzle Kit 的自省过程中曾经存在特殊处理问题。早期版本会生成不正确的代码：

duration: decimal("duration", { precision: 10, scale: 5 }) unsigne }),

这里有两个问题：

1. 错误地保留了 UNSIGNED 关键字的部分拼写
2. 实际上 MySQL 中 DECIMAL 类型的 UNSIGNED 属性已被弃用

正确的处理方式应该是忽略 UNSIGNED 属性，直接生成：

duration: decimal("duration", { precision: 10, scale: 5 })

最佳实践建议

1. 保持工具更新：确保使用最新版本的 Drizzle ORM 和 Drizzle Kit，以获得最稳定的类型处理支持

2. 手动检查生成代码：特别是在进行数据库自省后，应该检查生成的模式文件，确保所有类型导入和定义都正确

3. 了解类型映射：熟悉 Drizzle ORM 如何将 MySQL 类型映射到 TypeScript 类型，这有助于快速识别和修复潜在问题

4. 考虑类型替代方案：对于 DECIMAL 类型，考虑是否需要使用 UNSIGNED 属性，因为它的行为在 MySQL 中可能不符合预期

通过理解这些类型处理细节，开发者可以更高效地使用 Drizzle ORM 进行数据库开发，避免因类型问题导致的编译错误或运行时异常。