Troubleshooting
Fix common Cloudflare deployment issues.
Cloudflare Troubleshooting
"HTTP 401 Unauthorized"
Your API token is invalid or missing permissions. Verify:
- Token is active in API Tokens
- Token has permissions for the services you're using (D1, R2, Workers AI, Queues)
- Token is correctly set as
CF_API_TOKEN
"HTTP 429 Too Many Requests"
You've hit a rate limit:
- Workers AI: Check daily neuron usage
- D1: Check read/write quotas
- R2: Check operation quotas
Wait a few minutes or upgrade your plan.
"D1 database not found"
Verify the databaseId in your config matches the output of:
wrangler d1 list
"R2 bucket not found"
Verify the bucket exists:
wrangler r2 bucket list
Slow responses from Workers AI
Workers AI runs at the edge closest to your account. If you're far from the edge, latency may be higher. Consider:
- Using a model with lower latency (
@cf/meta/llama-3.1-8b-instructvs larger models) - Capping
maxTokensto reduce generation time
"Queue not found"
Verify the queue exists:
wrangler queues list