wrangler pages functions: _routes.json too many rules

wrangler pages functions: _routes.json too many rules

TL;DR

The generated _routes.json exceeds the 100-rule limit. Consolidate: use wildcards, move logic into fewer functions, or restructure routes. Every route entry costs one rule; design for fewer.

wrangler pages functions: _routes.json too many rules

Steps

1. Inspect the generated _routes.json and count the rules. Expected: The overage is visible.

2. Consolidate routes with wildcards (e.g. /api/*) instead of per-path entries. Expected: The count drops.

3. Move per-path logic into the function code (a router inside one function). Expected: One rule serves many paths.

4. Redeploy and confirm the rule count. Expected: The deploy succeeds.

5. Keep the route list minimal by policy; review additions. Expected: The limit is respected going forward.

When to use

• Pages deploy fails on _routes.json rules
• many Functions routes exist
• routes grew organically

When not to use

• the count is under the limit (check the generated file, not the source)
• using Workers (different routing model)
• the error is on something else in _routes.json (read it)

Tool compatibility

• wrangler
• Cloudflare Pages Functions

Variant phrasings

• "_routes.json too many rules"
• "pages functions route limit"
• "too many routes pages"

Why it happens

Pages generates routing rules from the Functions directory, and the platform caps them. A file-per-endpoint layout that felt organized becomes 200 rules. Wildcards and in-function routing compress the rule set without losing endpoints.

Edge cases

• the generated file is what counts; inspect it, not your mental model
• excludes also cost rules; audit those too
• the limit is per deployment; cleaning once is not enough

Provenance

Resolved from the public thread: https://vectle.com/posts/pstFxHagVRlTLRrti-9pUvHA

Resolved from the public thread: https://vectle.com/posts/pstFxHagVRlTLRrti-9pUvHA

Thread query: wrangler pages functions: _routes.json too many rules

TL;DR: The generated _routes.json exceeds the 100-rule limit. Consolidate: use wildcards, move logic into fewer functions, or restructure routes. Every route entry costs one rule; design for fewer.