橙宝书
常见问题

FAQ:Workers 与部署

回答 Workers/Pages、Custom Domain、Route、Secret、Node 兼容、后台任务和资源限制。

编辑与核验:橙宝书编辑团队 ·

FAQWorkers 部署7 个问题核验:2026-08-27

新项目应该选 Workers 还是 Pages?

先按框架官方支持和运行时需求选部署路径,不要只按旧产品印象。静态资产、SSR 和 Functions 最终都要核对 Workers 运行时、适配器与限制;对比入口见Workers、Pages 与其他平台

Custom Domain 和 Route 有什么区别?

Custom Domain 表示 Worker 自身就是该主机名的源站,Cloudflare 自动管理对应 DNS 和证书;Route 表示 Worker 在既有源站前执行,目标主机必须先有 Proxied DNS 记录。不要为没有源站的项目盲目创建 Route。

Wrangler 显示部署成功,为什么访问域名没有执行 Worker?

部署版本与绑定流量是两件事。核对当前账户、环境、Custom Domain/Route、Route pattern、DNS 是否 Proxied,以及请求是否命中正确主机和路径;先访问 workers.dev 或预览 URL 区分代码问题与路由问题。

普通环境变量和 Secret 有什么区别?

非敏感配置可以使用 vars;API key、签名密钥和数据库密码必须使用 Secret。Secret 不应写入仓库、wrangler.jsonc、客户端 bundle 或日志;完整边界见Bindings 与 Secrets

Workers 能直接运行所有 Node.js 包吗?

不能默认假设。nodejs_compat 提供的是不断演进的兼容层,包如果依赖原生二进制、完整文件系统或未实现的 Node API 仍可能失败。先查当前兼容文档,再做最小导入与部署测试,参考Node.js 运行时边界

返回响应后还能继续做后台任务吗?

可以把有界的非关键工作交给 ctx.waitUntil(),但它不是无限时长的可靠任务队列。需要重试、延迟、批量处理或长任务时使用 Queues、Workflows 或拆分任务,模式见异步工作

为什么本地能运行,部署后出现 1101 或 1102?

1101 常表示 Worker 抛出异常或未返回响应;1102 表示 CPU 或内存等资源边界被超出。结合 Workers Logs、invocation status、CPU/wall time 和版本定位,不要只提高限制掩盖无限循环或整块缓冲大文件的问题。

当前 Free 限制可以写死进架构吗?

不可以。2026-08-27 官方快照仍包含每日请求、CPU、包体和子请求边界,但这些值会变。发布当天打开 Limits,使用真实流量模型和内部红线,详见套餐、限制与成本核验

官方来源

这篇内容帮你完成目标了吗?

内测反馈只在当前浏览器生成,不会自动上传。

本页目录