Oban项目升级指南：从旧版本迁移至v2.11的最佳实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00014/article/details/148575831

Oban项目升级指南：从旧版本迁移至v2.11的最佳实践

oban 💎 Robust job processing in Elixir, backed by modern PostgreSQL or SQLite3 项目地址: https://gitcode.com/gh_mirrors/ob/oban

前言

Oban是一个强大的Elixir后台任务处理库，其v2.11版本引入了一些重要的架构改进。本文将详细介绍如何平滑升级到v2.11版本，包括必须执行的迁移步骤和推荐的优化措施。

准备工作：依赖项更新

首先需要更新项目依赖项到最新版本：

[
  {:oban, "~> 2.11"},
  {:oban_pro, "~> 0.10", repo: "oban"},
  {:oban_web, "~> 2.9", repo: "oban"}
]

核心变更：领导机制迁移

v2.11版本引入了全新的全局领导机制，这是本次升级最重要的变更。

必须执行的迁移

生成迁移文件：

mix ecto.gen.migration create_oban_peers

在生成的迁移文件中添加以下内容：

use Ecto.Migration

def up, do: Oban.Migrations.up(version: 11)
def down, do: Oban.Migrations.down(version: 11)

注意事项：

如果使用多个Oban实例或不同前缀，需要为每个前缀单独执行此迁移
系统会创建oban_peers表用于全局状态跟踪
即使表不存在，Oban.Peer模块也能正常工作，但会记录警告

通知器命名规范更新

v2.11统一了通知器的命名空间，需要做以下调整：

基础版Postgres通知器：

-notifier: Oban.PostgresNotifier
+notifier: Oban.Notifiers.Postgres

Pro版PG通知器：

-notifier: Oban.Pro.Notifiers.PG
+notifier: Oban.Notifiers.PG

多节点配置检查

新的领导机制需要特别注意多节点环境下的配置：

问题场景：

如果集群中不运行插件的节点成为领导者，可能导致任务卡在"available"状态
关键插件如Cron或Pruner可能无法运行

解决方案：

-plugins: false
+plugins: []

性能优化：索引重构（推荐）

v2.11建议调整复合索引的顺序以获得更好的查询性能。

何时需要此优化？

当遇到插件查询缓慢（如Stager插件）时，此优化特别有效。

实施步骤

生成迁移文件：

mix ecto.gen.migration swap_primary_oban_indexes

迁移文件内容：

@disable_ddl_transaction true
@disable_migration_lock true

def change do
  create_if_not_exists index(
    :oban_jobs,
    [:state, :queue, :priority, :scheduled_at, :id],
    concurrently: true,
    prefix: "public"
  )

  drop_if_exists index(
    :oban_jobs,
    [:queue, :state, :priority, :scheduled_at, :id],
    concurrently: true,
    prefix: "public"
  )
end

重要提示：