Matomo升级至5.x版本后管理员登录问题分析与解决

问题背景

在将开源网站分析平台Matomo从4.x版本升级到5.x版本的过程中，部分用户遇到了两个典型问题：

1. 文件完整性检查失败提示
2. 管理员登录时出现"array_intersect(): Argument #2 must be of type array, null given"的错误

问题分析

文件完整性检查失败

当用户使用新版本的global.ini.php配置文件时，系统会提示"File integrity check failed"错误。这通常表明：

• 文件在传输过程中可能被修改
• 文件上传模式不正确（如未使用二进制模式）
• 文件版本与Matomo核心版本不匹配

数组操作错误

当用户继续使用旧版本的global.ini.php文件时，系统会抛出数组操作相关的错误。这是因为：

• 5.x版本对配置文件的格式和内容有新的要求
• 旧版配置文件缺少新版所需的某些配置项
• 配置文件解析逻辑在5.x版本中有所改变

解决方案

正确获取配置文件

1. 从Matomo官方构建服务器下载对应版本的完整包
2. 解压后获取其中的global.ini.php文件
3. 确保文件版本与安装的Matomo核心版本完全一致

文件上传注意事项

1. 使用FTP/SFTP等工具上传时，必须选择二进制(BINARY)传输模式
2. 上传完成后验证文件大小是否与原始文件一致
3. 检查文件权限设置，确保Web服务器有读取权限

升级最佳实践

1. 在升级前备份现有配置文件和数据库
2. 按照官方升级指南逐步操作
3. 遇到问题时，优先使用对应版本的原始文件
4. 检查服务器环境是否满足新版本要求（PHP版本、扩展等）

后续维护建议

1. 定期检查Matomo的更新通知
2. 在测试环境验证升级过程后再应用到生产环境
3. 关注官方文档中关于配置文件变更的说明
4. 建立完整的升级和回滚流程

通过以上方法，可以确保Matomo升级过程的顺利进行，避免因配置文件问题导致的管理员登录失败等情况。