本地开发 · Cloudflare Queues docs

Queues 支持使用 Wrangler（Workers 的命令行接口）进行本地开发工作流。Wrangler 运行与 Cloudflare 全球部署相同版本的 Queues。

前提条件

要在本地使用 Queues 进行开发，您需要：

Wrangler v3.1.0 ↗ 或更高版本。
Node.js 版本 18.0.0 或更高。建议使用 Volta ↗ 或 nvm ↗ 等 Node 版本管理器，以避免权限问题并切换 Node 版本。
如果您是 Queues 和/或 Cloudflare Workers 新手，请参阅 Queues 教程以安装 wrangler 并部署第一个 Queue。

启动本地开发会话

打开终端并运行以下命令以启动本地开发会话：

npx wrangler@latest dev

------------------
Your Worker and resources are simulated locally via Miniflare. For more information, see: https://developers.cloudflare.com/workers/testing/local-development.

Your worker has access to the following bindings:
- Queues: <QUEUE-NAME>

本地开发会话会创建独立的、仅本地的环境，镜像 Queues 在生产中运行的环境，以便在部署到生产环境之前测试 Worker。

请参阅 wrangler dev 文档了解如何配置本地开发会话。

分离生产者与消费者 Worker

Wrangler 支持通过单条命令同时运行多个 Worker。若您的架构将生产者和消费者分为不同的 Worker，可使用此功能在本地测试完整的消息流。

例如，若项目具有以下目录结构：

producer-worker/
├── wrangler.jsonc
├── index.ts
└── consumer-worker/
    ├── wrangler.jsonc
    └── index.ts

可使用以下命令同时为两个 worker 启动开发服务器：

npx wrangler@latest dev -c wrangler.jsonc -c consumer-worker/wrangler.jsonc --persist-to .wrangler/state

当生产者 Worker 向队列发送消息时，消费者 Worker 将自动被调用来处理它们。

已知问题

Queues 不支持 Wrangler 远程模式（wrangler dev --remote）。