SuperAPI AI 工具集

workers-best-practices

部署与运维

查看项目

更新于 10-15 21:41

技能介绍

用途:在编写、审查或配置 Cloudflare Workers 生产应用时提供最佳实践参考。资料指出,对 Workers API、类型和配置的既有知识可能过时,因此写或审代码时应优先检索而非依赖预训练知识。

主要能力:以项目已安装版本、生成的类型和 Wrangler 兼容性设置为基线;检索 Cloudflare 文档核实 API、配置、运行时行为和限制。参考资料分三类:配置与可观测性(兼容性日期、绑定、生成类型、密钥、日志与追踪)、运行时模式(流式处理、Promise 生命周期、请求状态、服务调用、安全、运行时测试)、平台 API 检查(处理函数签名、平台类、绑定访问、序列化)。

使用方式:按任务读取相关章节;证据不足时查阅 Workers 最佳实践或 Cloudflare 文档目录;配置字段以已安装的 Wrangler schema 为准。新建 Worker 使用当天日期作为兼容性日期,并鼓励定期更新、审查兼容性变更并运行相关测试。创建或准备上生产时启用 Workers Logs 和 Traces,需同时设置 observability.enabled 与 observability.traces.enabled 为 true,使用结构化 JSON 日志并按负载配置采样。

需标记的反模式包括:对无界数据使用 await response.text() 等缓冲、硬编码密钥、用 Math.random() 生成安全敏感令牌、未 await/return/挂到 ctx.waitUntil() 的异步工作、模块级可变请求状态、可用绑定却调用 REST API、把 ctx.passThroughOnException() 当通用错误处理、手写 Env 重复 Wrangler 绑定、直接字符串比较密钥、解构 ctx 方法、对 Env 或处理函数参数用 any、用 as unknown as T 强转、用 implements 代替继承平台基类、平台类方法中未绑定的 env.X、对 Queues/Workflow/存储/WebSocket 套用同一序列化规则。

验证:使用项目现有检查,类型检查绑定或处理函数契约变更,行为变更运行相关运行时测试,保留必需的仓库检查。范围限于 Workers 特定实践与代码审查;Durable Objects、Workflows、Wrangler CLI 命令分别参考对应技能。