如何在运行Oban.Web的节点上禁用Oban Job执行？

错误原因 #

你碰到的ArgumentError是因为Oban的验证逻辑不允许队列的并发数（local_limit）设为0，必须大于0。直接给队列配置0并发会触发这个验证错误。

正确配置方案 #

要实现Web节点只跑Oban Web监控、不执行任务的需求，有两种可行方式：

方案1：配置空队列列表（推荐） #

在Web节点的Oban配置里，把queues设为空列表。这样Oban会启动核心服务（供Oban Web调用），但不会启动任何队列的工作进程：

config :my_app, Oban,
  queues: [],
  # 保留数据库连接、插件等必要配置，保证Oban Web能正常读取任务数据
  repo: MyApp.Repo,
  plugins: [Oban.Plugins.Pruner],
  # 若使用Oban Pro，保留Pro相关插件配置
  pro: [plugins: [Oban.Pro.Plugins.DynamicPruner]]

方案2：禁用Oban自动启动，手动启动Oban Web #

如果不想启动Oban核心进程，可以设置start: false，然后单独启动Oban Web组件。这种方式需要确保Oban Web能直接访问数据库配置，相对繁琐：

# Web节点的Oban主配置
config :my_app, Oban,
  start: false,
  repo: MyApp.Repo

# 在应用启动模块中手动加入Oban Web
defmodule MyApp.Application do
  use Application

  def start(_type, _args) do
    children = [
      MyApp.Repo,
      MyAppWeb.Endpoint,
      {Oban.Web, oban_config: Application.get_env(:my_app, Oban)}
    ]

    Supervisor.start_link(children, strategy: :one_for_one)
  end
end

注意事项 #

• Web节点和工作节点要共享相同的基础配置（比如数据库连接、插件），这样Oban Web才能获取所有节点的任务状态。
• 工作节点保持原有队列并发配置即可，示例：

# 工作节点的Oban配置
config :my_app, Oban,
  queues: [queue_1: 5, queue_2: 3, queue_3: 2],
  repo: MyApp.Repo,
  # 其他插件等配置

这样就能实现任务仅在专用工作节点执行，Web节点仅提供监控面板的需求。

内容的提问来源于stack exchange，提问作者Sheharyar