Symfony 6.2+ 中控制器类顶部使用 #[Route('/prefix')] 可统一设置路由前缀，自动拼接到类内各方法路径前（如 /admin/ + / → /admin/），但需注意斜杠不自动去重、类前缀参数不注入方法、且仅属性路由支持该特性，旧版 @Route 不兼容。
控制器类上用 #[Route] 设置前缀
在 Symfony 6.2+（PHP 8.1+）中，控制器类顶部加 #[Route] 注解即可统一设置路由前缀。这个前缀会自动拼接到所有该类中方法的 #[Route] 路径前面。
例如：
#[Route('/admin')]
class UserController
{
#[Route('/', name: 'admin_user_list')]
public function list(): Response { /* ... */ }
<pre class="brush:php;toolbar:false;">#[Route('/{id}', name: 'admin_user_show')]
public function show(int $id): Response { /* ... */ }}
实际注册的路由是 /admin/ 和 /admin/{id} —— 类前缀和方法路径按字面拼接，不自动去重斜杠，所以别写成 #[Route('/admin/')] + #[Route('/list')]，否则变成 /admin//list。
YAML 或 XML 配置里怎么设类前缀
如果你没用属性路由，而是用 YAML 或 XML 定义控制器路由，前缀得写在 controller 键值里，靠目录结构隐式体现，但 Symfony 本身不支持“类级前缀”语法。此时必须手动给每个 action 加前缀，或改用 collection 批量定义：
- YAML 中没有
prefix字段作用于整个控制器类 - 想批量加前缀，得用
controllers/目录 +type: annotation回退到注解方式，或者用import+prefix导入整个路由文件 - XML 同理，
<controller></controller>标签只接受单条路由，无法声明类前缀
结论：要享受类级前缀，就得用 PHP 属性路由（#[Route]），这是目前唯一可靠的方式。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
前缀里的占位符和默认值怎么传给方法
类前缀里写的参数（比如 #[Route('/api/{version}')]）会被合并进最终路由，但不会自动注入到 action 方法参数里 —— 只有方法上 #[Route] 显式声明的占位符才会绑定参数。
所以这类写法是无效的：
#[Route('/api/{version}')]
class PostController
{
public function list(string $version): Response { /* $version 不会被注入 */ }
}正确做法是把参数移到方法路由中，或用 defaults 显式传递：
#[Route('/api')]
class PostController
{
#[Route('/posts', defaults: ['version' => 'v1'])]
public function list(string $version): Response { /* OK */ }
}和旧版 @Route 注解兼容吗
不兼容。Symfony 6 默认禁用旧版 @Route（Doctrine Annotations），启用它需要额外装 doctrine/annotations 并开启配置。但即使开了，@Route 的类前缀行为也和 #[Route] 不完全一致：旧注解要求类前缀必须带 methods 或 name 才生效，且拼接逻辑更易出错。
建议直接用 #[Route]，避免混用。如果项目还在用 @Route，升级时注意检查所有控制器类是否漏了 name 导致前缀失效。
类前缀看着简单，但斜杠拼接、参数注入、配置方式这三处最容易翻车，尤其从 YAML 切过来的人常卡在“为什么加了 #[Route] 还不生效”——大概率是没删掉旧的 YAML 路由配置，导致两条路由同时注册，后者覆盖前者。
