控制器中调用generate()必须通过构造函数注入urlgeneratorinterface，不可new或container->get；参数键名须与路由占位符严格一致，第三个参数决定url类型且不可省略。
控制器里调用 generate() 必须注入 UrlGeneratorInterface
不能在控制器里 new UrlGenerator，也不能用 $this->container->get('router') —— 这两种写法要么报错，要么破坏可测试性。Symfony 5.4+ 默认启用自动服务注入，只要构造函数声明类型提示，容器就会自动传入实例。
常见错误现象：ArgumentCountError 提示缺少参数，或 IDE 提示 UrlGeneratorInterface 未定义，基本都是因为没走构造函数注入，而是试图手动获取服务。
- 正确做法：在控制器类中声明构造函数，接收
UrlGeneratorInterface $router - 若继承
AbstractController，可直接用$this->generateUrl()（它内部已封装好） - 不继承基类时，必须自己注入并保存为属性，否则每次都要重复声明依赖
generate() 的三个参数模式和实际用途
generate() 方法签名是 generate(string $name, array $parameters = [], int $referenceType = UrlGeneratorInterface::ABSOLUTE_PATH)。第三个参数决定生成的 URL 是相对路径、绝对 URL 还是协议无关路径，不是可有可无的“高级选项”，而是影响链接可用性的关键。
-
UrlGeneratorInterface::ABSOLUTE_PATH（默认）：生成/blog/symfony-url，适合模板内跳转或前端 JS 使用 -
UrlGeneratorInterface::ABSOLUTE_URL：生成https://example.com/blog/symfony-url，邮件、API 响应、重定向头中必须用这个 -
UrlGeneratorInterface::NETWORK_PATH：生成//example.com/blog/symfony-url，仅在混合 HTTP/HTTPS 环境且无法确定协议时才需要
漏传第三个参数导致邮件里点不开链接，或 API 返回的 URL 缺少域名，是线上最常被忽略的配置点。
参数键名必须和路由定义里的占位符 1:1 匹配
比如路由定义是 #[Route('/reset/{token}/{expires}', name: 'app_password_reset')]，那么 generate() 的第二个参数数组里，键必须是 'token' 和 'expires'，写成 'reset_token' 或 'token_id' 都会抛出 MissingMandatoryParametersException。
- 检查方式：运行
php bin/console debug:router app_password_reset，看输出中的 “Path” 行，提取花括号内的名字 - 可选参数（带
defaults的）可以不传，但所有必填占位符都得提供值 - 如果路由有
requirements（比如{id}），传入非数字会静默失败或生成空字符串，建议提前校验
调试生成失败的最简流程
调用 generate() 返回空字符串、抛异常或提示找不到路由，别急着翻文档，按顺序查这三项：
- 确认路由名拼写完全一致，包括大小写和下划线 ——
app_user_profile≠app-user-profile - 运行
php bin/console debug:router | grep your_route_name，确保该路由确实存在且已加载 - 执行
php bin/console router:match /your/test/path，验证路径是否真能匹配到该路由（排除路由顺序或 method 限制干扰）
缓存问题往往藏得深：开发环境改了路由注解但没清缓存，generate() 就会按旧规则找，结果自然失败。顺手加一句 php bin/console cache:clear 能省掉大半排查时间。
