最可靠方式是用 Symfony 的 generateUrl() 生成带 query 的 URL，query 参数必须通过第三个参数传入，接收时用 $request->query->get()，调试应绕过浏览器用 curl 验证。
generateUrl() 生成带 query 参数的 URL 最可靠
直接拼接 ?key=value 容易出错，尤其是参数含特殊字符或需要编码时。Symfony 提供的 $this->generateUrl()（控制器中）或 $router->generate()（服务中）能自动处理 URL 编码和参数合并。
关键点：
-
generateUrl()的第二个参数只接收「路由定义中的占位符」，比如{id}、{slug}，不接受 query 参数 - query 参数必须通过第三个参数（
$referenceType之后的数组）传入，键名为query - 示例：
$this->generateUrl('blog_show', ['id' => 123], ['query' => ['utm_source' => 'email', 'ref' => 'top']])→ 输出/blog/123?utm_source=email&ref=top - 如果路由本身有默认值（如
defaults: ['format' => 'html']），它不会自动出现在 query 中；只有显式写进query数组的才生效
路由匹配时不校验 query 参数，但生成时得手动加
Symfony 路由器只根据 path 匹配路由，?foo=bar 对匹配过程完全透明 —— 这意味着你不能在 @Route 注解或 YAML 中用 query 做条件判断，也不能靠它触发不同 controller。
常见误解与事实：
- 写
@Route("/search", requirements={"q": ".+"})是无效的 ——requirements只作用于 path 占位符，q不是占位符，是 query 字段 -
$_GET或$request->query->get('q')是获取 query 参数的唯一方式，它发生在路由匹配完成之后 - 想让某个 query 参数影响响应格式（如
?format=json），得在 controller 里手动判断，而不是指望路由自动跳转到另一个 action
前端跳转时 query 参数容易被覆盖或丢失
用 <a href="https://www.php.cn/link/781bb09f7e59ced95366df42706d0e43'some_route',%20%7Bid:%2042%7D)%20%7D%7D">Link</a> 生成链接时，如果当前 URL 已有 query（比如 ?page=2&sort=desc），Twig 的 path() 或 url() 函数默认不会继承它们 —— 它只按你传的参数生成，旧 query 会被清空。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
解决办法取决于场景：
- 要保留当前 query 并追加新参数？得手动合并：
{{ app.request.query.all|merge({'utm_medium': 'banner'})|url_encode }}，再拼进 href - 要用 JS 动态加参数？别用
window.location.href = '/foo' + '?' + params，改用URLSearchParams确保编码正确 - 表单提交带 query？
<form method="get"></form>会自动把字段转成 query，但注意：隐藏字段（<input type="hidden">）也会被包含，可能意外覆盖已有参数
调试时怎么确认 query 参数是否真被收到
别只看浏览器地址栏，也别只信 dd($request->query->all()) —— 某些代理、CDN 或安全中间件会过滤或重写 query 字符串。
快速验证步骤：
- 在 controller 开头加一行：
file_put_contents('/tmp/query.log', print_r($request->query->all(), true) . "\n", FILE_APPEND); - 检查日志是否含预期键值，特别注意大小写（
UTM_SOURCE≠utm_source）、空格、中文是否变成%E4%BD%A0类编码 - 如果值为空但地址栏明明有，可能是 Nginx 配置了
ignore_invalid_headers on，或用了proxy_buffering off导致 query 截断 - 用
curl -v "http://localhost:8000/test?hello=world&test=123"绕过浏览器，确认是前端问题还是后端解析问题
query 参数看着简单，但一旦混入编码、代理、缓存、前端框架（如 Vue Router 的 history 模式）或 CDN，就很容易漏掉或错乱。最稳的做法是：生成用 generateUrl(..., [...], ['query' => [...]])，接收用 $request->query->get() 显式取，调试时绕过浏览器直打 curl。
