cloudflare · Cloudflare Workers Docs
Workers Known issues
A collection of known bugs and platform limitations in Cloudflare Workers, including route specificity behavior, wrangler dev preview token restrictions, DNS requirements for CNAME setups, and restrictions on fetching...
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Known issues
A collection of known bugs and platform limitations in Cloudflare Workers, including route specificity behavior, wrangler dev preview token restrictions, DNS requirements for CNAME setups, and restrictions on fetching...
When To Use
Use when troubleshooting unexpected route matching, resolving 530 errors in CNAME setups, bypassing wrangler dev security restrictions, or attempting to fetch resources via IP addresses in a Worker script.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-known-issues-index-workflow-guide.md | A list of documented bugs and platform limitations regarding route specificity, wrangler dev, and Fetch API behavior in Cloudflare Workers. | Questions about a list of documented bugs and platform limitations regarding route specificity, wrangler dev, and Fetch API behavior... |
examples/workers-known-issues-index-cloudflare-workers-known-issues-list.text | A list of documented known issues and platform limitations for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A list of documented known issues and platform limitations for Cloudflare Workers. |
examples/workers-known-issues-index-cloudflare-workers-known-issues-list-2.text | A list of documented known issues and platform limitations for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A list of documented known issues and platform limitations for Cloudflare Workers. |
examples/workers-known-issues-index-cloudflare-workers-known-issues-request-heade.text | A code snippet demonstrating how to delete the cf-workers-preview-token header from a request object to mitigate a known issue. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to delete the cf-workers-preview-token header from a request object to mitigate a kn... |
examples/workers-known-issues-index-cloudflare-workers-dns-partial-setup-resoluti.text | A text example demonstrating how DNS records in a partial setup affect Fetch API resolution and cause 530 status codes in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text example demonstrating how DNS records in a partial setup affect Fetch API resolution and cause 530 status code... |
examples/workers-known-issues-index-cloudflare-workers-dns-partial-setup-known-is.text | A text representation of a DNS configuration scenario where a zone is in partial setup, illustrating how the Fetch API resolves subdomains. | Exact payloads, commands, or snippets shown in A text representation of a DNS configuration scenario where a zone is in partial setup, illustrating how the Fetch AP... |
examples/workers-known-issues-index-cloudflare-workers-known-issues-list-3.text | A list of documented platform limitations and known issues for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A list of documented platform limitations and known issues for Cloudflare Workers. |
examples/workers-known-issues-index-cloudflare-workers-known-issues-fetch-ip-addr.text | An example demonstrating the known issue where fetching a local IP address within a Cloudflare Worker fails. | Exact payloads, commands, or snippets shown in An example demonstrating the known issue where fetching a local IP address within a Cloudflare Worker fails. |
What This Skill Covers
- Below are some known bugs and issues to be aware of when using Cloudflare Workers.
- Main sections:
Route specificity,wrangler dev,Fetch API in CNAME setup,Fetch to IP addresses.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.cloudflare.com/workers/platform/known-issues/index.md