PostgreSQL编码问题：Doctrine查询西里尔姓名返回空列表如何解决

核心问题根因 #

该场景下搜索返回空并非单一配置错误导致，是三层匹配链路存在断层：

• PostgreSQL 的 LOWER() 函数对西里尔字符的支持依赖数据库 collation 配置，默认无俄语 locale 的数据库根本无法正确转换西里尔字符的大小写
• PHP 原生 strtolower() 仅支持 ASCII 字符范围的转换，无法处理多字节编码的西里尔字符
• 此前尝试的 SQL_ASCII charset 配置会彻底破坏多字节字符的存储与读取流程，从连接链路层面就会导致字符乱码

分步修正方案 #

1. 修正 Doctrine 连接编码配置 #

直接替换此前的错误charset 配置，注意 pdo_pgsql 驱动要求的编码值必须和 PostgreSQL 客户端支持的编码完全匹配，不能混用大小写或错误编码，正确配置结构如下：

'doctrine' => [
    'connection' => [
        'dbname' => 'app',
        'user' => 'app',
        'password' => 'secret',
        'host' => 'db',
        'driver' => 'pdo_pgsql',
        'charset' => 'UTF8',
    ]
]

• 绝对不要使用 SQL_ASCII 作为连接编码：该编码会将所有多字节字符按单字节二进制处理，西里尔字符存库、读库全流程都会变成乱码，从源头就无法匹配
• 小写 utf8 对部分老版本 pdo_pgsql 驱动存在识别兼容问题，必须写 PG 官方支持的标准编码名 UTF8

2. 修正搜索逻辑，绕开多端大小写匹配的断层 #

原有写法在西里尔字符场景下必然失效，有两种可直接落地的修正方式：

方案A（推荐）：使用 PostgreSQL 原生 ILIKE 匹配

ILIKE 是 PG 自带的不区分大小写的模糊匹配语法，不需要在PHP、数据库两端分别做大小写转换，直接按照字段的 collation 规则完成匹配，彻底避开多语言大小写的兼容问题，对应代码写法：

// 删除原有的LOWER()嵌套和PHP端strtolower处理
$qb->andWhere('user.name ILIKE :searchTerm')
    ->setParameter('searchTerm', '%' . $query['name'] . '%');

方案B：保留 LOWER() 写法的兼容修正

如果必须使用 LOWER() 做匹配，需要同时修正两端的逻辑：

• 数据库端：确保存储 name 字段的表/库配置了支持俄语的 collation（如 ru_RU.UTF-8），否则 LOWER() 根本不会对西里尔字符做小写转换
• PHP 端：把原生 strtolower() 换成支持多字节的 mb_strtolower()，并且显式指定编码为 UTF-8，否则 PHP 端生成的搜索词根本不会正确转成西里尔小写，对应代码写法：

$qb->andWhere('LOWER(user.name) LIKE :searchTerm')
    ->setParameter('searchTerm', mb_strtolower('%' . $query['name'] . '%', 'UTF-8'));

上线前必做验证 #

直接进入数据库执行两条原生SQL验证，无需通过应用层逐层排查：

• 执行 SELECT name FROM users LIMIT 5; 确认返回的西里尔字符没有乱码，排除存储层面的问题
• 执行 SELECT LOWER('ИВАН'); 确认返回值能正确变成小写的 иван，如果返回的还是原大写内容，说明数据库的 collation 配置不支持西里尔字符转换，需要先调整字段的collation 再做应用层修改

内容的提问来源于stack exchange，提问作者pickle rick