symfony 不支持 {_controller} 作为路径占位符实现自动映射；它仅是内部参数，用于匹配后指定控制器。正确做法是显式定义如 {id} 等占位符并配 requirements 正则约束，结合前缀路由与控制器分组实现资源分发。
动态占位符必须显式声明，不能靠{_controller}自动映射
你写 /api/{_controller} 本意可能是想让 /api/product 自动调用 ProductController，但 Symfony 不会这么做。它会把 product 当作服务 ID 或类名去查，结果报错：Controller "product" does neither exist as service nor as class.
真正起作用的只有你明确定义的占位符，比如 {id}、{slug}、{year}。它们会被提取并原样传进控制器方法参数里。
- 占位符名必须和方法参数名完全一致（大小写敏感），否则注入失败
-
{_controller}是 Symfony 内部保留参数，只在路由匹配完成后用于指定目标控制器，不能出现在路径中 - 若要实现“按资源名分发”，应使用控制器分组 + 前缀路由，而不是通配路径
requirements 正则约束不是可选装饰，而是安全边界
不加 requirements 的 {id} 会接受任意字符串，包括空值、SQL 注入片段或路径遍历字符（如 ../etc/passwd）。Symfony 不会自动过滤或转义它。
常见误用是只对数字 ID 加 \d+，却放任 {username} 或 {token} 没有约束。
- 用户名推荐：
requirements={"username": "[a-zA-Z0-9_]{3,32}"} - UUID 推荐：
requirements={"id": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"} - 正则末尾不要加
^和$—— Symfony 已自动包裹，重复会导致匹配失败 - YAML 中写正则需用单引号，避免 YAML 解析器误读反斜杠
defaults 让参数可选，但要注意类型一致性
defaults={"page": 1} 看似简单，但若控制器方法签名是 public function list(int $page)，而用户访问 /list（无 page）时，Symfony 会把字符串 "1" 注入进去 —— PHP 8+ 严格模式下直接 TypeError。
这不是 bug，是设计使然：defaults 提供的是原始字符串值，类型转换由方法签名或参数解析器决定。
- 用
int类型声明时，确保defaults值是数字字符串（如"1"），而非1（整数）—— YAML 中数字字面量会被解析为 int，可能触发类型不匹配 - 对可选参数，更稳妥的做法是设为
null默认，并在方法内做判断：public function show(?int $id) - 多个默认值同时存在时，任一缺失都会触发全部 defaults 合并，不是“局部 fallback”
host 匹配比 path 参数更适合多租户或子域场景
想让 admin.example.com/users 和 api.example.com/v1/posts 走不同逻辑？别在 path 里塞 {env} 或 {domain}，那只是把问题往后推 —— 你仍得在控制器里 if-else 分流，且无法利用路由缓存做前缀优化。
真正该做的是用 host 键做一级分发：
- 注解写法：
@Route(host="{domain}", requirements={"domain": "admin\.example\.com|api\.example\.com"}) - YAML 写法：在
config/routes.yaml里为每个 host 单独定义一个路由集合，用host键隔离 - 注意：
host匹配优先级高于path，且要求strict_requirements: true才能生效（开发时可临时关掉） - 如果域名含通配符（如
*.example.com），需改用condition表达式，因为 requirements 不支持通配符正则
最易被忽略的一点：路由编译后，所有正则约束和 host 匹配都固化进 PHP 数组结构里 —— 这意味着你改了 requirements 却没清缓存，新规则根本不会生效。每次调整动态参数行为，都要跑一遍 bin/console cache:clear。
