Matomo数据库字符集转换问题分析与解决方案

问题背景

在使用Matomo 5.1.2版本时，系统检查工具建议用户执行console core:convert-to-utf8mb4命令将数据库字符集从utf8mb3转换为utf8mb4。然而在执行该命令后，系统出现了大量排序规则(Collation)错误，导致服务器无法正常跟踪访问数据。

技术分析

utf8mb4是MySQL 5.5.3版本引入的完整UTF-8实现，支持4字节的Unicode字符，而utf8mb3(即传统的utf8)仅支持最多3字节的字符。Matomo建议使用utf8mb4以获得更好的国际化支持。

当执行字符集转换命令时，虽然所有表都成功转换为utf8mb4字符集，但系统检查工具仍显示数据库排序规则为utf8mb3_general_ci，这表明转换过程中排序规则未被正确更新。

根本原因

1. 配置未更新：转换命令虽然修改了数据库表的字符集，但未正确更新Matomo配置文件中的排序规则设置。

2. 字符集与排序规则不匹配：utf8mb4字符集应搭配对应的utf8mb4排序规则(如utf8mb4_general_ci或utf8mb4_unicode_ci)，而不应与utf8mb3的排序规则混用。

3. 系统检查工具显示不一致：转换后系统检查工具显示数据库字符集为utf8mb4，但排序规则仍为utf8mb3_general_ci，这种不匹配导致了功能异常。

解决方案

通过修改Matomo配置文件(config.ini.php)中的数据库配置部分，显式设置排序规则为utf8mb4_general_ci：

[database]
collation = "utf8mb4_general_ci"

这一修改确保了字符集和排序规则的匹配，解决了系统功能异常问题。

最佳实践建议

1. 执行转换前的备份：在进行任何数据库字符集转换前，务必创建完整的数据库备份。

2. 验证转换结果：转换后应检查所有表的字符集和排序规则是否一致。

3. 监控系统性能：utf8mb4会占用更多存储空间，转换后应监控系统性能变化。

4. 测试功能完整性：转换完成后应全面测试Matomo的各项功能，确保数据跟踪和报表生成正常。

总结

Matomo从utf8mb3到utf8mb4的转换是一个重要但需要谨慎操作的过程。通过正确配置排序规则，可以确保转换后的系统稳定运行。对于遇到类似问题的用户，检查并更新配置文件中的排序规则设置是最直接有效的解决方案。