Drizzle ORM 中 PostgreSQL 更新多行数据时的大小写问题解析

在使用 Drizzle ORM 进行 PostgreSQL 数据库操作时，开发者可能会遇到一个常见但容易被忽视的问题：当尝试使用 onConflictDoUpdate 方法进行批量更新操作时，如果表字段名包含大写字母，会出现 "column excluded.name does not exist" 的错误。

问题现象

当开发者按照官方文档提供的 buildConflictUpdateColumns 辅助函数来实现批量更新时，对于包含大写字母的字段名（如 teorAlcoolico），PostgreSQL 会报错提示找不到对应的列。错误信息显示系统将字段名全部转换为小写（如 teoralcoolico），导致无法正确匹配。

根本原因

PostgreSQL 默认情况下会将未加引号的标识符转换为小写形式。在 Drizzle ORM 生成的 SQL 语句中，当使用 excluded.columnName 这样的语法时，PostgreSQL 会自动将 columnName 转换为小写形式进行匹配。如果实际表结构中字段名包含大写字母，就会导致匹配失败。

解决方案

正确的做法是在引用字段名时使用双引号包裹，保持原始大小写形式。修改 buildConflictUpdateColumns 函数如下：

function buildConflictUpdateColumns<T extends PgTable, Q extends keyof T["_"]["columns"]>(
  table: T,
  columns: Q[]
) {
  const cls = getTableColumns(table);
  return columns.reduce((acc, column) => {
    const colName = cls[column]!.name;
    acc[column] = sql.raw(`excluded."${colName}"`);
    return acc;
  }, {} as Record<Q, SQL>);
}

关键修改点是在字段名周围添加了双引号：excluded."${colName}"。这样 PostgreSQL 就会按照原始大小写形式来匹配字段，解决了大小写转换导致的问题。

最佳实践

1. 字段命名一致性：在设计数据库时，尽量保持字段命名风格一致，推荐使用全小写加下划线的命名方式（如 teor_alcoolico），可以避免这类问题。

2. 引号使用规范：当字段名包含大写字母、特殊字符或与保留关键字冲突时，务必使用双引号包裹。

3. ORM 配置检查：使用 Drizzle ORM 时，注意检查生成的 SQL 语句是否符合 PostgreSQL 的语法要求。

4. 测试覆盖：对于包含不同命名风格的字段，应该增加相应的测试用例，确保各种情况下的操作都能正常工作。

通过理解 PostgreSQL 的标识符处理机制和正确使用引号语法，开发者可以避免这类大小写敏感性问题，确保 Drizzle ORM 的批量更新操作能够稳定可靠地执行。