Cloudflare Worker配置路由后未触发，求排查提示
2026-6-16
排查Cloudflare Worker路由未触发的思路
检查路由与Worker的绑定关系
确认Workers Routes页面中，该路由绑定的Worker名称和你部署的Worker完全一致，排查是否存在拼写错误或选错Worker的情况。核实路由匹配规则的准确性
- 确认路由pattern包含完整域名：如果你的请求域名是带后缀的（如
myapp.com），而路由配置仅写了myapp/resources-v2/*，会导致匹配失败，需修正为完整域名格式（如myapp.com/resources-v2/*）。 - 检查是否存在优先级更高的路由：Cloudflare路由遵循“最具体优先”原则，若存在其他更匹配当前请求的路由（如
myapp/resources-v2/very long/*），且该路由未绑定Worker或绑定了其他Worker，会覆盖当前路由的触发逻辑。
- 确认路由pattern包含完整域名：如果你的请求域名是带后缀的（如
排查Worker代码逻辑
- 临时添加日志验证触发状态：在Worker代码最开头插入
console.log("Worker triggered:", request.url);，发起请求后查看Worker日志（Workers→目标Worker→Logs），确认是否有日志输出，排除代码提前返回但无日志的情况。 - 检查代码中的过滤逻辑：确认Worker代码里没有针对请求路径、方法或请求头的过滤规则导致提前跳过处理。
- 临时添加日志验证触发状态：在Worker代码最开头插入
确认域名的Cloudflare代理状态
查看该域名对应的DNS记录，确保是橙色云标识（已启用Cloudflare代理），若为灰色云（仅DNS解析），Cloudflare不会拦截请求，无法触发Worker。检查缓存规则的干扰
如果请求的资源被Cloudflare缓存，且缓存规则设置为绕过Worker，请求会直接返回缓存内容。可临时在请求中添加Cache-Control: no-cache头，或在Cloudflare缓存规则中排除该路径的缓存后重试。验证区域（Zone）的正确性
再次确认zone_id对应的区域确实是当前请求域名所在的区域，排查是否因多区域混淆导致路由绑定到了错误的域名区域。测试简化请求路径
使用无空格、无特殊字符的简化路径（如https://myapp/resources-v2/test）测试，排除路径中的特殊字符可能导致的匹配异常。
内容的提问来源于stack exchange，提问作者A-friendly-gopher
相关产品推荐
相关产品推荐
