prefix是Symfony路由中作用于整个导入资源的路径前缀，仅存在于路由配置文件或控制器类级@Route中，不支持单个路由或注解参数，且与控制器命名空间无关。
prefix 是 Symfony 路由系统中用于批量添加路径前缀的配置项，它不作用于单个路由，而是作用于整个路由资源导入（resource）——比如一个 YAML 文件、一个控制器类、或一个 Bundle 的全部路由。
你不能在 @Route 注解里写 prefix，也不能在单个 Route 对象里设它。它的位置只在「导入路由时」的配置层级。
YAML 路由文件中用 prefix 导入外部路由资源
这是最常见也最推荐的用法，尤其当你引入第三方 Bundle（如 OverblogGraphQLBundle）或按模块拆分路由时：
-
prefix必须和resource同级，且只能出现在config/routes/xxx.yaml这类顶层路由配置中 - 它会对
resource所含的所有子路由统一加前缀，包括其中嵌套的prefix - 注意：如果被导入的 YAML 文件（如
graphql.yml）本身也定义了prefix，两者会叠加
示例（config/routes/graphql.yaml）：
overblog_graphql_endpoint:
resource: '@OverblogGraphQLBundle/Resources/config/routing/graphql.yml'
prefix: /graphdata
此时原 /graphql 端点就变成 /graphdata/graphql；若该 bundle 内部路由还定义了 prefix: /api，最终就是 /graphdata/api/graphql。
@Route 注解不支持 prefix，但可用控制器类级注解模拟
PHP 属性（或旧版注解）本身没有 prefix 参数，但 Symfony 支持在控制器类上使用 @Route，其路径会自动作为所有方法路由的前缀：
- 类级
@Route("/admin")+ 方法级@Route("/users")→ 实际匹配/admin/users - 类级注解的
path会与方法级path拼接，不是覆盖 - 类级注解不能设
methods或requirements，这些必须在方法级单独声明
示例：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
#[Route('/api')]
class ApiController extends AbstractController
{
#[Route('/posts', name: 'api_posts_list')]
public function list(): Response { ... }
#[Route('/posts/{id}', name: 'api_posts_show', requirements: ['id' => '\d+'])]
public function show(string $id): Response { ... }
}
两个路由实际路径分别是 /api/posts 和 /api/posts/{id}。
别把 prefix 和控制器命名空间前缀混淆
有人误以为在 config/packages/framework.yaml 中设置 controllers 的 php_attributes 或 annotation 配置能影响 URL 前缀——不会。那只是控制「是否扫描某目录下的控制器」，和 URL 路径完全无关。
-
framework.controller配置决定哪些 PHP 类会被当作控制器加载，不影响路由生成 -
prefix只存在于路由导入上下文（routes/*.yaml）或类级@Route中 - 如果你改了控制器类名或命名空间，URL 不会自动变；反之，URL 改了，控制器类名也不必动
调试和验证 prefix 是否生效的最快方式
运行以下命令，检查实际注册的路由是否已带预期前缀：
php bin/console debug:router | grep your_route_name
或者直接访问：
- 查看
/_profiler→ 「Router」面板，点开具体路由看Path - 注意：
debug:router输出的是最终合并后的路径，已包含所有prefix层级 - 如果没看到前缀，大概率是 YAML 文件没被正确加载（检查文件名是否符合
config/routes/*.yaml规则，或是否漏了import）
真正容易被忽略的点是：YAML 路由文件名必须以 .yaml 结尾，且放在 config/routes/ 下才能被自动加载；手动 import 则需确保路径拼写绝对正确（Bundle 别名要带 @，相对路径要用双引号）。
