Laravel测试环境中Cookie无法设置与读取问题排查

我正在开发一个使用Cookie的Laravel包，通过检测Cookie的存在及值来展示对应内容。我使用基于PHPUnit的Orchestra Testbench进行测试，测试中路由返回200状态码且视图可正常展示，但测试环境下Cookie无法正常设置和读取，生产环境代码则可正常运行。

控制器方法示例 #

public function __invoke(): View|Closure|string
{
    return view('view', ['cookie' => request()->cookie('name')]);
}

测试方法示例 #

public function test_content_shows_with_cookie()
{
    $response = $this->withCookie('name', 'value')
        ->get('/route');

    $response->assertSee('success');
}

遇到的问题 #

• 无论采取何种操作，request()->cookie('name')始终返回null，包括下文提到的方法。
• 上述测试方法无法实际设置Cookie，例如dd($response->headers->getCookies())返回空数组；而以下方法可将Cookie附加到请求中，但应用仍无法读取：

$response = $this->call('GET', '/route')
    ->withCookie('name', 'value');

请问：能否通过Orchestra Testbench在测试环境中验证Cookie的值？若可以，我哪里操作有误？若不行，应尝试什么方案（比如Dusk）？

Orchestra Testbench完全支持Cookie的测试，你的问题出在测试方法的调用顺序和配置细节上：

1. 修正Cookie设置的调用顺序 #

你第二种写法里把withCookie()放在call()之后是错误的，withCookie()是请求构建器的前置方法，必须在发送请求（get()/call()）之前调用，否则不会生效。正确写法和你第一个测试示例一致，但要确保路由与视图逻辑的关联没有问题。

2. 排查Cookie读取为null的原因 #

• 大小写不一致：Laravel读取Cookie区分大小写，确保测试中设置的名称和控制器里读取的完全匹配。
• 加密配置影响：Laravel默认加密Cookie，测试环境下可临时禁用加密来排查问题，在测试类的setUp方法中添加：

protected function setUp(): void
{
    parent::setUp();
    config(['app.cookie_encryption' => false]);
}

注意：此设置仅用于测试，生产环境请勿禁用加密。

• 中间件缺失：如果路由使用了web中间件组，需确保Testbench环境中正确加载了处理Cookie的中间件。可在测试类的getEnvironmentSetUp方法中注册：

protected function getEnvironmentSetUp($app)
{
    $app['router']->middlewareGroup('web', [
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        // 其他必要的web中间件
    ]);
}

3. 正确验证Cookie的方式 #

不要通过响应头查看Cookie，直接断言视图接收的值或页面内容更准确：

public function test_content_shows_with_cookie()
{
    $response = $this->withCookie('name', 'value')->get('/route');
    
    // 断言视图接收到的Cookie值
    $response->assertViewHas('cookie', 'value');
    // 或断言页面展示的内容
    $response->assertSee('success');
}

如果以上方案都无法解决问题，再考虑使用Laravel Dusk进行浏览器端测试——它会模拟真实浏览器的Cookie处理逻辑，适合复杂的前端Cookie交互场景。但对于后端包的测试，Testbench完全足够，优先排查上述配置问题。

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