EF Core PostgreSQL 中关于 COLLATION 引号问题的技术解析

引言

在使用 Entity Framework Core 与 PostgreSQL 数据库进行开发时，数据库迁移(Migration)是一个常见的操作。近期有开发者反馈在 PostgreSQL 17.2 版本中遇到了 COLLATION 定义被双引号转义导致的问题。本文将深入分析这一现象的原因，并提供解决方案。

问题现象

当开发者在 EF Core 模型配置中使用 UseCollation("NOCASE") 方法时，生成的迁移代码会自动为 COLLATION 名称添加双引号：

CREATE TABLE "Users" (
    "Username" character varying(255) COLLATE "NOCASE" NOT NULL,

在 PostgreSQL 17.2 版本中，这种带双引号的 COLLATION 定义会导致执行失败。

问题根源分析

PostgreSQL 标识符处理机制

PostgreSQL 对数据库对象标识符(如表名、列名、COLLATION 名称等)有一套特殊的处理规则：

1. 大小写敏感性：默认情况下，PostgreSQL 会将所有未加引号的标识符转换为小写
2. 引号的作用：使用双引号包裹的标识符会保留原始大小写形式

EF Core 的设计考虑

EF Core 在设计上采取了保守策略，默认对所有标识符添加双引号，目的是：

1. 确保跨不同数据库系统时标识符大小写的一致性
2. 防止因大小写转换导致的意外行为
3. 保持与代码中定义完全一致的数据库结构

解决方案

方案一：统一 COLLATION 命名大小写

1. 在创建 COLLATION 时使用双引号明确指定大写形式：

CREATE COLLATION "NOCASE" (provider = icu, locale = 'und-x-icu.utf8', deterministic = false)

2. 这样 EF Core 生成的带引号的 COLLATION 名称就能正确匹配

方案二：使用小写 collation 名称

1. 创建 COLLATION 时不使用引号，让其自动转为小写：

CREATE COLLATION nocase (provider = icu, locale = 'und-x-icu.utf8', deterministic = false)

2. 在 EF Core 配置中也使用小写：

.UseCollation("nocase")

最佳实践建议

1. 一致性原则：在整个项目中保持 COLLATION 命名大小写的一致性
2. 显式定义：在 SQL 中创建对象时明确使用引号或不使用引号，避免依赖默认行为
3. 环境验证：在开发、测试和生产环境中验证 COLLATION 定义的一致性
4. 文档记录：在项目文档中记录 COLLATION 的命名约定

技术深度解析

PostgreSQL 的标识符处理机制源于其 SQL 标准的实现。当执行：

CREATE COLLATION NOCASE

实际上创建的是名为 nocase 的 collation（自动转为小写）。而 EF Core 生成的：

COLLATE "NOCASE"

明确要求查找名为 NOCASE（大写）的 collation，因此会导致找不到对象的错误。

总结

理解 PostgreSQL 标识符处理规则与 EF Core 的保守策略之间的交互是解决此类问题的关键。通过统一命名规范或在 SQL 创建语句中显式使用引号，可以避免 COLLATION 定义不匹配的问题。作为开发者，我们应该在项目初期就制定好数据库对象的命名约定，并在整个团队中贯彻执行，以减少此类问题的发生。