PG-Boss任务队列中任务消失问题分析与解决方案

问题现象

在使用PG-Boss任务队列系统时，用户发现队列中约100万个已排队多日（约7天）的任务突然消失。这种现象与文档中描述的15分钟任务过期时间明显不符，引起了使用者的困惑。

根本原因分析

经过排查，发现问题出在PG-Boss的任务保留策略上。PG-Boss默认配置了30天的任务保留期限（retentionDays），超过此期限的任务会被系统自动清理。这与用户最初认为的15分钟过期时间（实际上是任务执行超时设置）是完全不同的两个概念。

解决方案

要解决这个问题，可以通过以下配置调整：

const boss = new PgBoss({
  retentionDays: 365 // 将任务保留期限延长至1年
});

技术要点解析

1. 任务保留期限：控制任务在队列中的最长存储时间，与任务执行超时是完全独立的配置项
2. 默认值差异：
   • 任务执行超时（expireIn）：默认15分钟
   • 任务保留期限（retentionDays）：默认30天
3. 适用场景：对于需要长期排队但执行频率较低的任务，必须适当调整retentionDays参数

最佳实践建议

1. 根据业务需求合理设置retentionDays参数
2. 对于重要任务建议设置更长的保留期限
3. 定期监控队列中任务的积压情况
4. 考虑实现任务状态持久化机制，作为额外保障

总结

PG-Boss作为基于PostgreSQL的任务队列系统，其任务生命周期管理包含多个维度。理解并正确配置各项时间参数，特别是区分任务执行超时和存储保留期限，是保证系统可靠运行的关键。通过合理配置retentionDays参数，可以有效避免任务意外消失的问题。