用途:为 Inngest 持久函数添加跨越所有函数的横切能力,如日志、追踪、错误跟踪、依赖注入与数据加解密。
主要能力:中间件是 Inngest 执行管道上的钩子,可在函数运行、事件发送等生命周期节点运行。可注册在客户端级(影响所有函数)或函数级(仅影响特定函数);客户端中间件先于函数中间件按声明顺序执行。内置 dependencyInjectionMiddleware 可注入 OpenAI、Prisma 等客户端。官方独立包包括 @inngest/middleware-encryption(加密步骤数据、函数输出和事件数据,支持 fallbackDecryptionKeys 轮换密钥)与 @inngest/middleware-sentry(捕获异常、为每次函数运行添加追踪,需 @sentry/*@>=8.0.0)。
用法:用 new InngestMiddleware({ name, init }) 创建中间件,在 init 中返回 onFunctionRun 或 onSendEvent 等生命周期钩子,如 beforeExecution、afterExecution、transformOutput、transformInput,再通过 middlewares 数组注册。安装示例:npm install @inngest/middleware-encryption、npm install @inngest/middleware-sentry。
限制:技能主要面向 TypeScript,Python 或 Go 需参考 Inngest 官方文档,核心概念跨语言通用。中间件系统在 v4 大幅重写,本技能描述的是 v4 API,从 v3 迁移需查阅迁移指南。Realtime 应使用 inngest-realtime 技能,v4 原生支持 step.realtime.publish,不需要 @inngest/realtime,在 v4 项目安装该包会在运行时抛出 TypeError: Cls is not a constructor。配置细节与完整示例见其依赖注入与中间件参考文档。