Matomo 5.2.0版本归档任务内存泄漏问题分析与解决方案

问题背景

Matomo是一款流行的开源网站分析平台，在5.2.0版本更新后，许多用户报告在执行归档任务(core:archive)时遇到了内存耗尽的问题。这一问题尤其影响拥有大量网站(超过700个)的实例，导致定期执行的归档任务失败。

问题表现

用户在执行归档任务时，会收到类似以下错误信息：

Allowed memory size of 268435456 bytes exhausted (tried to allocate 28672 bytes)

即使将内存限制提高到256MB甚至更高，问题仍然存在。相比之下，在5.2.0版本之前，同样的任务在512MB内存限制下就能正常运行。

根本原因分析

经过Matomo开发团队的调查，发现问题主要源于5.2.0版本引入的新"hits"指标。这一变更导致系统为当前年份的所有报告创建了回溯填充的无效记录(invalidations)。在归档过程中，系统会跳过与未完成归档周期重叠的周期(例如，如果一周中的某天尚未归档，则该周不会被处理)，这些被跳过的无效记录会不断累积，最终导致内存耗尽。

解决方案

临时解决方案

1. 限制处理数量 使用--max-archives-to-process参数限制单次运行的归档数量：

   ./console core:archive --max-archives-to-process=500
   

   这样可以减少内存使用量，但需要多次运行直到所有无效记录都被处理。

2. 减少并发请求 降低并发归档请求数量：

   ./console core:archive --concurrent-requests-per-website=1
   

   这会延长归档时间，但能显著减少内存使用。

3. 手动清理无效记录 对于高级用户，可以手动清理与"hits"指标相关的无效记录：

   DELETE FROM matomo_archive_invalidations 
   WHERE report = 'Actions_hits' AND ts_started IS NULL AND status = 0;
   

   清理后，可以针对特定日期范围重新触发归档。

长期解决方案

Matomo开发团队已经确认这是一个需要修复的问题，并计划在后续版本中解决。建议用户关注官方更新，及时升级到修复版本。

最佳实践建议

1. 对于大型Matomo实例，建议监控归档任务的内存使用情况
2. 考虑将归档任务拆分为多个小任务，使用不同的时间间隔执行
3. 定期检查archive_invalidations表，确保没有堆积的无效记录
4. 在升级前，先在测试环境中验证归档任务的稳定性

总结

Matomo 5.2.0版本引入的内存问题主要影响大规模部署环境，通过合理的任务拆分和参数调整可以有效缓解。开发团队已经意识到这一问题的重要性，预计将在未来版本中提供更彻底的解决方案。在此期间，用户可以采用本文提供的临时解决方案确保系统稳定运行。