Symfony测试中assertResponseRedirects相对路径不生效问题

问题场景 #

我是Symfony和测试领域的新手，编写登录错误凭证测试时遇到了问题：

• 使用$this->assertResponseRedirects('/login')断言重定向到相对路径，测试失败
• 替换为绝对路径http://localhost/login后，测试通过

不清楚相对URI为何失效，也不确定测试中应该使用绝对还是相对路径。

测试代码 #

public function testLoginWithBadCredentials(): void
{
    $client = static::createClient();
    $crawler = $client->request('GET', '/login');
    $form = $crawler->selectButton('Login')->form([
        '_username' => 'user@user.com',
        '_password' => 'wrongpassword',
        '_dob' => '25/06/1485'
    ]);
    $client->submit($form);

    $this->assertResponseRedirects('/login');
        
    //...
}

登录表单代码 #

<form action="{{ path('app_login') }}" method="post">
    <label for="username">Email:</label>
    <input type="text" id="username" name="_username" value="{{ last_username }}">

    <label for="password">Password:</label>
    <input type="password" id="password" name="_password">

    <label for="dob">Date of birth:</label>
    <input type="text" id="dob" name="_dob">

    <input type="hidden" name="_target_path" value="/">

    {# Prevent Login CSRF attacks #}
    <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">

    <button type="submit">Login</button>
</form>

错误信息 #

Failed asserting that Symfony\Component\HttpFoundation\RedirectResponse Object &00000000000005450000000000000000 (
     ├     'headers' => Symfony\Component\HttpFoundation\ResponseHeaderBag Object &00000000000005170000000000000000 (
     ├         'headers' => Array &0 (
     ├             'cache-control' => Array &1 (
     ├                 0 => 'max-age=0, must-revalidate, private'
     ├             )
     ├             'date' => Array &2 (
     ├                 0 => 'Wed, 22 Feb 2023 02:59:15 GMT'
     ├             )
     ├             'location' => Array &3 (
     ├                 0 => 'http://localhost/login'
     ├             )
     ├             'content-type' => Array &4 (
     ├                 0 => 'text/html; charset=UTF-8'
     ├             )
     ├             'x-robots-tag' => Array &5 (
     ├                 0 => 'noindex'
     ├             )
     ├             'expires' => Array &6 (
     ├                 0 => 'Wed, 22 Feb 2023 02:59:15 GMT'
     ├             )
     ├         )
     ├         'cacheControl' => Array &7 (
     ├             'max-age' => '0'
     ├             'must-revalidate' => true
     ├             'private' => true
     ├         )
     ├         'computedCacheControl' => Array &8 (
     ├             'max-age' => '0'
     ├             'must-revalidate' => true
     ├             'private' => true
     ├         )
     ├         'cookies' => Array &9 ()
     ├         'headerNames' => Array &10 (
     ├             'cache-control' => 'Cache-Control'
     ├             'date' => 'Date'
     ├             'location' => 'Location'
     ├             'content-type' => 'Content-Type'
     ├             'x-robots-tag' => 'X-Robots-Tag'
     ├             'expires' => 'Expires'
     ├         )
     ├     )
     ├     'content' => '<!DOCTYPE html>\r\n
     ├ <html>\r\n
     ├     <head>\r\n
     ├         <meta charset="UTF-8" />\r\n
     ├         <meta http-equiv="refresh" content="0;url='http://localhost/login'" />\r\n
     ├ \r\n
     ├         <title>Redirecting to http://localhost/login</title>\r\n
     ├     </head>\r\n
     ├     <body>\r\n
     ├         Redirecting to <a href="http://localhost/login">http://localhost/login</a>.\r\n
     ├     </body>\r\n
     ├ </html>'
     ├     'version' => '1.1'
     ├     'statusCode' => 302
     ├     'statusText' => 'Found'
     ├     'charset' => 'UTF-8'
     ├     'targetUrl' => 'http://localhost/login'
     ├ ) is redirected and has header "Location" with value "/login".

问题原因 #

Symfony的assertResponseRedirects方法默认是严格匹配响应头里的Location值的。
从错误信息可以看到，响应头的Location是http://localhost/login——这是因为在测试环境中，Symfony生成重定向响应时（比如登录控制器里使用$this->redirectToRoute('app_login')），会基于测试客户端的默认base URL（http://localhost）生成完整的绝对URL，所以响应头里的Location是绝对路径，和传入的相对路径/login完全不匹配，导致断言失败。

解决方案 #

方案1：用路由名称生成URL（推荐） #

直接通过路由名称生成正确的URL，Symfony会自动处理绝对/相对路径的问题，测试代码与路由配置解耦，后续路由路径变更时无需修改测试：

$this->assertResponseRedirects($this->generateUrl('app_login'));

方案2：关闭严格匹配模式 #

assertResponseRedirects的第三个参数是$strict，默认值为true，设置为false后会忽略域名部分，只检查路径是否匹配：

$this->assertResponseRedirects('/login', 302, false);

这种方式能解决问题，但不如方案1健壮——如果后续路由路径修改，测试会直接失败，而使用路由名称会自动适配新路径。

方案3：使用绝对路径（不推荐） #

直接用http://localhost/login作为断言目标，但这种方式依赖测试环境的base URL，若更换测试环境（比如服务器域名不同），测试会直接失效，维护性较差。

测试最佳实践 #

测试重定向时，优先使用路由名称生成URL，让测试代码更健壮，与具体URL路径解耦；如果必须使用路径，优先选择关闭严格模式，避免依赖环境的base URL。

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