Oban Web 中已完成作业列表显示问题的分析与解决

问题现象

在使用 Oban Web 界面时，用户可能会遇到一个奇怪的现象：已完成作业列表持续显示"没有作业匹配当前筛选条件"，即使系统实际上有大量已完成作业。左侧的计数器会实时更新，但列表内容却始终为空。

问题根源

经过深入分析，发现这个问题与 Oban Web 的查询机制有关。系统默认会限制查询结果为最近的 100,000 条作业记录，然后在这些记录中筛选已完成状态的作业。如果已完成作业不在最近的 100,000 条记录中，就会出现列表为空的情况。

解决方案

方法一：增加查询限制

可以通过自定义解析器来调整查询限制：

defmodule MyApp.Resolver do
  @behaviour Oban.Web.Resolver

  def jobs_query_limit(_state), do: :infinity
end

然后在路由配置中指定使用这个解析器：

scope "/" do
  pipe_through :browser

  oban_dashboard "/oban", resolver: MyApp.Resolver
end

方法二：优化作业处理流程

对于长期运行的系统，还可以考虑以下优化措施：

1. 定期归档已完成作业，减少主表中的数据量
2. 根据业务需求设置合理的作业保留策略
3. 监控作业完成速度与总量，提前调整系统配置

实现原理详解

Oban Web 的查询机制采用了"先限制后筛选"的策略，这种设计主要出于性能考虑。对于作业量大的系统，直接查询所有记录可能会对数据库造成压力。但这也带来了上述显示问题。

当设置为 :infinity 时，系统会查询所有记录，然后进行筛选。虽然这解决了显示问题，但需要注意可能带来的性能影响，特别是当作业表数据量非常大时。

最佳实践建议

1. 根据系统规模合理设置查询限制，平衡显示需求与性能
2. 对于生产环境，建议结合作业清理策略使用
3. 定期监控系统性能，特别是当作业量增长时
4. 考虑实现分级存储，将历史作业移至归档表

通过理解这一机制并合理配置，可以确保 Oban Web 界面始终正确显示系统状态，为运维工作提供可靠支持。