ReportPortal数据库清理优化指南：解决PostgreSQL数据膨胀问题

问题背景

在使用ReportPortal进行测试报告管理时，随着时间推移，PostgreSQL数据库可能会出现数据膨胀问题。典型表现为数据库存储空间异常增长，如案例中提到的680GB数据量。这主要是由于长期积累的测试运行数据(launch data)未被及时清理所致。

核心解决方案

1. 项目级别的数据保留策略配置

ReportPortal提供了项目级别的数据保留策略设置，这是最基础的清理机制：

• 登录ReportPortal管理员账户
• 进入具体项目的设置页面
• 找到"数据保留策略"配置项
• 设置合理的日志保留期限（如14天）
• 保存配置后，系统将自动清理过期数据

2. 定时清理任务配置优化

通过修改docker-compose.yml文件中的定时任务配置，可以增强清理频率：

services:
  jobs-service:
    environment:
      - CLEAN_LAUNCH_CRON=0 */30 * * * *
      - CLEAN_ATTACHMENT_CRON=0 */30 * * * *
      - CLEAN_SCREENSHOT_CRON=0 */30 * * * *

配置说明：

• CLEAN_LAUNCH_CRON：控制测试运行数据的清理频率
• CLEAN_ATTACHMENT_CRON：控制附件的清理频率
• CLEAN_SCREENSHOT_CRON：控制截图的清理频率
• 0 */30 * * * *表示每30分钟执行一次

修改后需要重启ReportPortal服务使配置生效。

3. PostgreSQL数据库维护操作

当常规清理机制效果不明显时，需要直接对PostgreSQL数据库执行维护操作：

VACUUM操作

VACUUM (VERBOSE, ANALYZE) table_name;

VACUUM FULL操作（更彻底但会锁表）

VACUUM FULL (VERBOSE, ANALYZE) table_name;

使用pg_repack工具（无需锁表）

pg_repack -d reportportal -t table_name

实施建议

1. 分阶段实施：先配置项目保留策略和定时任务，观察效果后再考虑数据库维护操作
2. 业务低峰期操作：VACUUM FULL等操作会影响数据库性能，建议在非工作时间执行
3. 监控机制：设置数据库空间监控，提前预警
4. 定期维护：将数据库维护操作纳入常规运维计划

注意事项

• 修改配置前建议备份重要数据
• 生产环境执行VACUUM FULL前应评估业务影响
• 定期检查清理任务日志，确认自动清理机制正常运行
• 对于大型数据库，维护操作可能需要较长时间完成

通过以上方法的组合应用，可以有效解决ReportPortal数据库膨胀问题，保持系统高效稳定运行。