Trigger.dev 项目从 v2 升级到 v3 的完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00650/article/details/148394242

Trigger.dev 项目从 v2 升级到 v3 的完整指南

trigger.dev ✨ Trigger.dev is the open source background jobs framework for TypeScript. With features like API integrations, webhooks, scheduling and delays. 项目地址: https://gitcode.com/gh_mirrors/tr/trigger.dev

前言

Trigger.dev 是一个强大的后台任务处理平台，最新发布的 v3 版本带来了重大架构改进。本文将深入解析 v2 到 v3 的升级路径，帮助开发者顺利完成迁移。

核心架构变化

v3 版本最显著的改进是采用了长期运行的服务器架构（除非自行托管），这带来了以下关键变化：

无超时限制：不再受限于服务器less函数的执行时间限制
简化任务定义：移除了 io.runTask() 和 cacheKeys 等冗余概念
标准化SDK使用：直接使用官方SDK而非集成包
任务模型重构：task 取代 job 成为基础构建块

迁移策略详解

1. 任务定义转换

v2 使用复杂的 job 定义结构：

// v2 示例
client.defineJob({
  id: "my-job",
  trigger: eventTrigger({...}),
  run: async (payload, io) => {
    await io.runTask("task-name", async () => {...});
  }
});

v3 简化为直接的 task 定义：

// v3 示例
import { task } from "@trigger.dev/sdk/v3";

export const myTask = task({
  id: "my-task",
  run: async (payload: {参数类型}) => {
    // 直接编写业务逻辑
  }
});

2. 第三方服务集成

v2 使用特定集成包：

// v2 OpenAI 集成
import { OpenAI } from "@trigger.dev/openai";
const openai = new OpenAI({...});

v3 直接使用官方SDK：

// v3 OpenAI 使用
import OpenAI from "openai";
const openai = new OpenAI({...});

3. 任务触发机制

v2 有多种触发方式：

// v2 触发方式
await client.sendEvent({...});  // 事件触发
await job.invoke({...});       // 直接调用

v3 统一为 .trigger() 方法：

// v3 统一触发
await myTask.trigger({...});

实际案例对比：OpenAI 集成

v2 实现

// v2 OpenAI 示例
client.defineJob({
  run: async (payload, io) => {
    const result = await io.openai.chat.completions.backgroundCreate(
      "task-id",
      { messages: [...] }
    );
    await io.wait("wait-id", 300);
    return result;
  }
});

v3 实现

// v3 OpenAI 示例
export const openaiTask = task({
  run: async (payload) => {
    const result = await openai.chat.completions.create({
      messages: [...]
    });
    await wait.for({ minutes: 5 });
    return result;
  }
});