Skip to content

Workers 本地调试 ​

启动 ​

bash
npm run dev:wrangler

访问:

text
http://localhost:8787/api/demo

如果提示未登录 ​

使用环境变量登录:

bash
npx wrangler login

如果你的 Cloudflare 令牌已经配置好,也可以直接运行:

bash
npx wrangler whoami

本地 R2 调试 ​

本地调试时,wrangler 会尝试使用你配置的 Cloudflare 凭证访问真实 R2 Bucket。

如果你只想测试函数逻辑,可以先不读写 R2,只返回:

ts
return Response.json({ message: 'ok' });

常见错误 ​

binding DEMO_BUCKET not found ​

检查 wrangler.toml 是否有:

toml
[[r2_buckets]]
binding = "DEMO_BUCKET"
bucket_name = "cloudflare-learning-lab"

The bucket does not exist ​

先创建 Bucket:

bash
npx wrangler r2 bucket create cloudflare-learning-lab

网络慢或失败 ​

中国大陆访问 Cloudflare API 有时不稳定。可以先:

  • 使用稳定的网络环境。
  • 检查代理。
  • 使用 npx wrangler --help 确认 wrangler 可运行。
  • 把错误信息记录下来,再根据具体错误排查。

Cloudflare Learning Lab