symfony 7路由调试需关注参数验证、正则锚定、缓存干扰及注解加载配置；注解路由须在routes.yaml中显式声明并启用annotations；requirements正则必须用^$锚定；paramconverter有隐式约束；https链接失效源于信任头未正确配置。
Symfony 7 的路由不是“写完就跑”，关键在参数验证是否真正生效、正则是否被正确解析、缓存是否干扰调试——这些环节出错，debug:router 显示正常，但实际请求 404 或 500，非常隐蔽。
注解路由必须启用且加载路径正确
很多人改完 @Route 没反应，根本原因是路由没被加载。Symfony 7 默认仍依赖 config/routes.yaml 中的声明，不是“有注解就自动注册”。
- 确认
config/routes.yaml包含控制器目录的 annotation 加载项：controllers: resource: ../../src/Controller/ type: annotation -
framework.yaml必须有annotations: true（Symfony 7 已默认开启，但自定义配置可能覆盖） - 路径层级写错会导致整个目录不被扫描：比如
../../src/Controller/实际是../src/Controller/，debug:router就不会列出任何注解路由 - 类名或命名空间错误（如漏写
use SymfonyComponentRoutingAnnotationRoute;）会让 PHP 解析失败，但 Symfony 不报错，只是跳过该方法
requirements 正则必须用完整锚定表达式
Symfony 对 requirements 的正则不做自动包裹，"id": "d+" 看似能匹配 123，但也会意外匹配 abc123def —— 因为没加 ^ 和 $。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 安全写法永远带首尾锚点：
requirements={"id": "^\d+$"}（注意双反斜杠，PHP 字符串中需转义） - 排除特定值要用负向先行断言：
requirements={"slug": "^(?!admin|login).+$"}，否则/post/admin仍会命中/post/{slug} - 空字符串匹配陷阱：
"slug": ".+"不匹配/post/（尾部无 slug），但"slug": ".+"+defaults={"slug": "index"}也不生效——因为requirements优先于defaults，空值先被拒绝 - 复杂正则建议先用在线工具（如 regex101.com）验证，再粘贴进注解，避免因转义错误导致路由静默失效
ParamConverter 自动注入与手动查库的取舍
@Route("/post/{id}") + public function show(Post $post) 看似省事，但隐含两个关键约束：实体必须有主键映射、且未找到时硬抛 404。这不总是合理。
- ParamConverter 默认按主键查找，若你用 UUID 或复合主键，需显式指定字段：
#[Route('/post/{uuid}', name: 'post_show')] public function show(Post $post)要配合#[ParamConverter('post', options: ['mapping' => ['uuid' => 'uuid']])] - 想返回 302 而非 404？必须禁用 ParamConverter，改用手动查询：
$post = $this->em->find(Post::class, $id); if (!$post) { return $this->redirectToRoute('post_list'); } - 多个参数共用同一实体？比如
/category/{slug}/post/{id}，ParamConverter 无法自动区分哪个参数用于哪个实体，必须手动查 - 性能敏感场景慎用：每个 ParamConverter 都触发一次 DB 查询，批量渲染列表页时，N+1 问题比手写 DQL 更难察觉
HTTPS 下路由生成链接失效的根源
本地开发用 symfony server:start 访问 https://localhost:8000，结果所有 $this->generateUrl() 生成的都是 http:// 链接——这不是路由配置问题，而是信任头没设对。
- Web 服务器（Nginx/Apache/Caddy）必须透传
X-Forwarded-Proto，且值为https - Symfony 必须明确信任该头：
framework.yaml中设置trusted_proxies: ['127.0.0.1']和trusted_headers: [x-forwarded-proto] - 否则
$request->isSecure()永远返回false，所有 URL 生成器强制用http - Cloudflare 或 AWS ALB 等代理还可能改写
X-Forwarded-For，导致trusted_proxies判定失败，需按实际代理 IP 更新配置
最常被忽略的是缓存：改完路由后只清了 var/cache/dev，但生产环境用 OPcache 或 APCu，cache:clear 不一定刷新全部；debug:router 显示的路由，未必是当前请求实际匹配的那条——先 cache:clear --env=prod 再测，别省这一步。
