Symfony含%2F的路由参数引发「无路由匹配」问题求助

这个问题我之前也踩过坑！核心原因是服务器会自动把URL路径中的%2F解码为真实的斜杠/，而Symfony默认的路由参数匹配规则不允许参数包含斜杠——当你访问/qrCode/generate/800%2F08SL300001时，服务器实际收到的路径是/qrCode/generate/800/08SL300001，这时候你的路由/qrCode/generate/{eakte}只会把800当作eakte参数，后面的/08SL300001就成了多余的路径段，自然会提示「无路由找到」。

下面给你两种靠谱的解决方案：

方案一：修改路由配置，允许参数包含斜杠 #

直接在路由注解里添加requirements，用正则表达式允许参数包含任意字符（包括斜杠）：

/**
 * @Route("/qrCode/generate/{eakte}", requirements={"eakte"=".+"})
 * @param $eakte
 * @return Response
 */
public function generateQrCodeAction($eakte)
{
    $qrService = $this->get("app.qrcode");
    // 注意：此时$eakte是解码后的字符串，即"800/08SL300001"
    $qrService->generate_qr_code($eakte);
    return new Response("done");
}

如果你的Symfony版本是5.1+，还可以加上allow_slashes选项让配置更清晰：

/**
 * @Route("/qrCode/generate/{eakte}", requirements={"eakte"=".+"}, options={"allow_slashes": true})
 * @param $eakte
 * @return Response
 */

这样路由就会把800/08SL300001（也就是原URL中%2F解码后的结果）完整匹配为eakte参数，路由就能正常命中了。

方案二：改用查询参数传递（更稳妥） #

如果你的业务需要保留原始的URL编码字符串（比如要拿到800%2F08SL300001而不是解码后的800/08SL300001），建议改用查询参数传递，避免路径分隔符的干扰：

修改路由为不带路径参数的形式：

/**
 * @Route("/qrCode/generate")
 * @param Request $request
 * @return Response
 */
public function generateQrCodeAction(Request $request)
{
    $eakte = $request->query->get('eakte');
    // 此时$eakte就是原始的编码字符串："800%2F08SL300001"，如果需要解码可以用rawurldecode($eakte)
    $qrService = $this->get("app.qrcode");
    $qrService->generate_qr_code(rawurldecode($eakte)); // 根据需要解码
    return new Response("done");
}

访问时用这个URL：/qrCode/generate?eakte=800%2F08SL300001，这样就完全不会有路由匹配的问题了。

额外提示 #

如果用方案一还是遇到问题，可能是你的Web服务器（Apache/Nginx）自动解码了%2F，这时候需要在服务器配置里禁用这个行为：

• Apache：在虚拟主机配置里添加AllowEncodedSlashes NoDecode
• Nginx：在location块里添加merge_slashes off;

不过大部分情况下，修改Symfony路由的requirements就足够解决问题了。

内容的提问来源于stack exchange，提问作者MehdiB