用途:帮助实现 Vercel Queues 的生产者与消费者,依据 Vercel Queues 文档与 SDK 契约编写代码。
主要能力与参考路径:首次搭建最小生产者+消费者看 references/quickstart.md;SDK 用法、选项、重试与传输行为看 references/sdk.md;API 级集成(自定义客户端、非 SDK 消费者)看 references/api.md;投递语义与架构决策看 references/concepts.md;轮询 worker 与 push/poll 混合设计看 references/poll-mode.md;本地搭建与调试看 references/local-dev.md。任务跨多类时只读相关文件。
核心约束:投递为至少一次,消费者必须设计为幂等;Vercel 上默认选 push 模式,除非明确需要定时/批量/客户端驱动的轮询;poll 模式需固定显式区域,且发送与接收使用同一区域;对毒消息采用有界重试(达到阈值后 acknowledge: true);topic 与 consumer 名称需匹配 ^[A-Za-z0-9_-]+$。
实现方式:标准 Vercel push 模式优先用顶层 send 与 handleCallback;仅在需要自定义选项(transport、token、headers、deploymentId)时用 QueueClient;poll 模式用 PollingQueueClient 接收,并显式处理 { ok: false, reason: "empty" };vercel.json 的 trigger 映射需显式且限定到消费者路由。
验证与排错:确认生产者返回 messageId,可空 messageId 视为可接受的延迟确认;验证成功、重试、毒消息路径;核对可见性超时与任务时长匹配;核对 poll 模式区域。认证问题查 OIDC/token 来源与环境加载;投递缺失查 topic 名、trigger 注册与区域一致性;重复处理查幂等键策略与消费者幂等;积压增长查吞吐、重试策略与可见性超时。
限制:资料未提供具体价格、平台支持范围与性能指标,暂未提供。