TYPO3 11.5.30中uploads内容类型按标题排序变音符号异常问题

排查方向和解决办法 #

1. 确认元数据字段的排序规则 #

别只看表级的排序规则，得检查sys_file_metadata表的title字段本身的排序规则是不是utf8mb4_unicode_ci。表级规则不代表每个字段都会继承，可能这个字段单独设了别的规则。进phpMyAdmin直接查看该字段的属性即可。

2. 强制TYPO3用指定规则排序 #

TYPO3构建查询时可能没带上排序规则，导致数据库用了默认行为。试试在页面TSconfig里添加这段配置：

tt_content.uploads.20 {
  sorting = title
  sorting.direction = ASC
  sorting.field = sys_file_metadata.title
  sorting.orderBy = sys_file_metadata.title COLLATE utf8mb4_unicode_ci
}

添加完成后清空TYPO3的所有缓存，再测试排序效果。

3. 检查TYPO3数据库配置 #

查看LocalConfiguration.php里的DB连接配置，确保字符集和排序规则配置正确：

'DB' => [
    'Connections' => [
        'Default' => [
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            // 其他配置项...
        ],
    ],
],

如果配置有误，修改后记得清空缓存。

4. 直接测试数据库查询 #

在phpMyAdmin里执行SQL语句，验证数据库本身的排序是否正常：

SELECT * FROM sys_file_metadata ORDER BY title COLLATE utf8mb4_unicode_ci ASC;

如果这个查询结果里变音符号排序正常，说明问题出在TYPO3的查询逻辑上，可能需要通过钩子或自定义扩展调整排序逻辑；如果查询结果仍异常，可通过SQL语句修改字段排序规则：

ALTER TABLE sys_file_metadata MODIFY title VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

5. 升级TYPO3补丁版本 #

TYPO3 11.5.30可能存在排序相关的已知bug，官方后续的小版本可能修复了该问题。尝试升级到11.5系列的最新版本（比如11.5.35及以上），再测试排序是否正常。

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