Webman路由性能依赖FastRoute的前置正则约束，需在Route::add()层面显式定义如{id:\d+}，避免控制器层校验；route.php缓存机制要求环境变量和依赖必须在编译前就绪，否则触发重复编译拖慢性能。
Webman 的路由性能本身已经很高，但不当的配置会让 FastRoute 的优势打折扣；参数过滤不能只靠控制器里手动 filter_input，得在路由层就卡住非法输入。
Route::get() 和 Route::add() 的实际差异
多数人只用 Route::get()、Route::post() 这类快捷方法，但它们本质是 Route::add() 的封装。真正影响性能和约束能力的是底层调用方式：
-
Route::get('/user/{id}', ...)不带正则约束时，{id}默认匹配任意非斜杠字符，容易被恶意路径绕过（比如/user/..%2Fetc%2Fpasswd） - 改用
Route::add('GET', '/user/{id:\d+}', ...)显式声明\d+，FastRoute 会在分发前直接拒绝非数字请求，不进控制器、不触发中间件 - 批量注册时，
Route::group()内部仍调用Route::add()，但注意：组内中间件是运行时叠加，不是编译期合并，过多嵌套组会轻微拖慢 Dispatcher 初始化
参数过滤必须在路由定义里做，而不是在控制器里
把参数校验逻辑写在控制器里（比如用 filter_var($id, FILTER_VALIDATE_INT)）看似简单，但已浪费了 FastRoute 的前置拦截能力。真实问题常出现在：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 攻击者发送
GET /api/order/abc，控制器里判断失败后才返回 400，此时日志、中间件、DB 连接池可能已被触发 - 高频无效请求会堆积在事件循环中，尤其搭配 WebSocket 或长连接时，容易引发
Connection reset by peer - 正确做法是在路由定义阶段就用正则约束，例如：
Route::get('/api/order/{order_id:[a-zA-Z0-9]{16}}', [...]) - 复杂规则可抽成命名模式，在
config/route.php顶部统一注册：Route::addPattern('uuid', '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}');，后续直接用{id:uuid}
route.php 文件加载顺序与缓存失效风险
config/route.php 是每次请求都 require 的，但 FastRoute 的路由数据结构在第一次请求时编译后会缓存到 runtime/cache/route.php。这个机制带来两个隐性坑：
立即学习“PHP免费学习笔记（深入）”；
- 修改
route.php后没清缓存，新路由不生效，错误提示却是NotFoundHttpException，容易误判为路径写错 - 若在
route.php中引入了依赖容器或调用了env()，而这些值在缓存生成后变更（如切换环境），会导致路由行为不一致 - 生产环境建议关闭自动缓存：在
config/app.php中设'route_cache'=>false，改用预编译脚本（php webman route:cache）控制时机 - 调试阶段可临时加
if (env('APP_DEBUG')) { Route::clearCache(); }到route.php开头，避免反复手动删文件
FastRoute 的路由编译是一次性动作，但它的“一次性”依赖于你是否让所有动态逻辑（比如条件路由、环境分支）在编译前就收敛。最易被忽略的是：在 route.php 里调用未初始化的类、或使用了尚未加载的配置项，会导致缓存写入失败，进而每次请求都重新编译——这时候性能反而比传统框架还差。
