symfony 7.x路由命名必须以app_开头，否则自动发现失效；注解须用php attributes语法，路径正则约束应内联书写，子域名路由需显式声明host属性。
路由命名必须以 app_ 开头，否则自动发现会失效
Symfony 7.x 默认启用命令与路由的自动发现机制，但前提是命名空间和命名都符合约定。路由名不是随便起的字符串，它直接影响缓存生成、调试输出和安全校验逻辑。如果你用 overblog_graphql_endpoint 这类第三方 bundle 提供的名称，没问题；但自定义路由必须以 app_ 为前缀，否则 debug:router 可能不显示，或在 security.yaml 中引用时因找不到而报错 RouteNotFoundException。
常见错误现象：
- 运行
php bin/console debug:router列表为空或缺失你的路由 - 在
security.yaml的access_control中写path: ^/admin却始终 403，实际是路由名没被识别导致权限规则未生效 - 使用
$this->generateUrl('admin_dashboard')报错，提示 “The route ‘admin_dashboard’ does not exist”
正确做法：
- 控制器注解中用
@Route("/admin", name="app_admin_dashboard") - YAML 路由文件里写
app_admin_edit_user: {...}，而非admin_edit_user - 模块级路由统一加二级前缀，比如用户模块用
app_user_*，API 模块用app_api_v1_*
注解路由优先用 PHP Attributes，别混用旧式 Annotations
Symfony 7.x 已完全转向 PHP 8.1+ Attributes 语法，@Route 类注解（即 Doctrine-style）已被弃用，且在 PHP 8.2+ 环境下可能触发 deprecation warning 甚至解析失败。这不是风格偏好问题，而是兼容性硬约束。
容易踩的坑：
- 复制旧项目代码，保留
use SensioBundleFrameworkExtraBundleConfigurationRoute;和@Route(...)，结果路由不注册也不报错，静默失效 - 同时存在 Attributes 和旧注解，导致同一方法被重复注册，引发
DuplicateRouteNameException - IDE（如 PhpStorm）未更新 Symfony 插件，仍提示旧注解可用，实际运行时报错
正确写法（仅一种）：
#[Route('/api/posts/{id}', name: 'app_api_post_show', methods: ['GET'])]
public function show(int $id): Response
{
// ...
}
注意：methods 参数必须是数组，name 是键值对形式，不能写成 name="app_api_post_show"（那是旧注解语法）。
路径参数正则限制要写在 attributes 里，别丢进 requirements
Symfony 7.x 的 Attributes 路由支持内联正则约束，比 YAML/XML 中单独写 requirements 更安全、更易维护。把 {id} 直接写在路径里，就等价于旧方式里的 requirements: { id: '\d+' }，但前者在编译期校验，后者只在运行时匹配。
为什么这样做：
- 避免 YAML 文件里 requirements 和 path 不同步，比如路径写
{slug}，requirements 却配{id: '\d+'}，导致 404 或匹配错路由 - IDE 能对
{id}做语法高亮和校验，对分离的 requirements 无法感知 - Bundle 自动加载时，YAML 的 requirements 若含非法转义（如
\d写成d），会导致整个路由文件加载失败，且错误提示模糊
典型场景示例：
- 文章 ID 必须数字：
/posts/{id} - Slug 允许字母数字和短横线：
/articles/{slug} - 多段可选参数（如分页）：
/search{page?}
子域名路由必须显式声明 host，不能只靠 request.host
想用 admin.example.com 跳转到后台，或 api.example.com 区分接口路由？别指望中间件或控制器里判断 $request->getHost() 再手动跳转——那样既破坏路由职责，又让缓存、生成 URL 和安全策略全部失效。
正确方式是直接在路由定义里用 host 属性：
#[Route('/dashboard', name: 'app_admin_dashboard', host: 'admin.{domain}', requirements: ['domain' => 'example.com'])]
public function dashboard(): Response
{
// ...
}
关键点：
-
host是一级匹配条件，和path并列，不写就默认匹配所有 host - 动态 domain 需配合
requirements，否则{domain}会被当成字面量，匹配失败 - 生成 URL 时，
$this->generateUrl('app_admin_dashboard', ['domain' => 'example.com'])才能正确输出https://admin.example.com/dashboard
最容易忽略的是：本地开发时用 localhost 测试子域名路由，必须在 hosts 文件里配好 127.0.0.1 admin.localhost，否则 Nginx/Apache 根本收不到该 host 的请求，路由永远不命中。
