Symfony路由含斜杠(/)的参数无法正常工作问题排查

问题原因 #

Web服务器（如Apache、Nginx）默认会将URL中的%2F解码为实际的/，导致Symfony路由匹配时，原本属于domainName参数的部分被识别为新的路径分段，从而无法匹配到目标路由。

解决方案 #

1. 配置Web服务器禁止解码%2F #

• Apache：
  在项目根目录的.htaccess文件或虚拟主机配置中添加以下指令：

  AllowEncodedSlashes NoDecode
  

• Nginx：
  在对应站点的location配置块中添加：

  merge_slashes off;
  

  同时确保传递原始请求URI给PHP-FPM，例如：

  fastcgi_param REQUEST_URI $request_uri;
  

2. 确认Symfony路由配置 #

保持原有的注解路由配置即可，.+正则表达式已能匹配包含%2F的参数：

#[Route('/getFtp/{customerName}/{taskId}/{domainName}', name: 'get_ftp', requirements: ['domainName' => '.+'])]
public function index(string $customerName, string $taskId, string $domainName): Response

完成上述配置后，包含%2F的URL就能正确匹配路由，domainName参数也会获取到包含%2F的原始值。

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