SuperAPI AI 工具集

cloudflare-workers

部署与运维

查看项目

更新于 10-15 21:38

技能介绍

用途:为在 Cloudflare Workers 上编写与调试代码提供模式参考,覆盖 Worker 运行时 API、Durable Objects、KV、R2、D1、Queues、WebSockets、流式响应、bindings 与 wrangler 配置等。

主要能力与规则:每个异步副作用都必须被 await、return,或传给 c.executionCtx.waitUntil(...);浮动 Promise 不安全,因为响应后 isolate 可能停止。waitUntil 需作为 c.executionCtx 的方法调用,不要解构。waitUntil 的工作应保持有界且尽力而为,需要保证或长时间运行的工作应使用 Queues。使用 Hyperdrive 加 pg 时,每个请求创建新的 pg.Client,并在所有使用该客户端的排队工作完成后关闭;Hyperdrive 本身即连接池。Node 风格数据库驱动需要 Worker 配置中的 nodejs_compat。WebSocket 升级请求应跳过通用响应头中间件(包括 CORS),因为 101 响应头不可变。有状态或长连接 WebSocket 应放在 Durable Objects 中;当对象持有大量空闲套接字时优先使用支持休眠的 API。应信任生成的 Worker 绑定类型(如 Cloudflare.Env),并在绑定或 wrangler 配置变化时重新生成。

参考与核实:涉及 Worker 运行时行为、绑定、Durable Objects、WebSockets、流式、缓存 API、service bindings、兼容日期、限制或 wrangler 配置影响正确性时,可先针对 cloudflare/cloudflare-docs 提出窄问题;Hono 相关问题以 honojs/hono 为依据。改动代码前,用本地生成的 Worker 类型、源码或官方 Cloudflare 文档核实关键细节。稳定的 Web API 基础与代码中已可见的仓库本地部署模式可跳过查询。

限制:资料未提供具体安装命令、价格、平台支持范围或效果数据。