Laravel功能测试中每次HTTP请求后Session ID变更问题排查

我在编写Laravel功能测试时发现，每次HTTP请求后Session ID值都会发生变化。例如，以下代码中每次dump出的ID都不相同：

dump(session()->getId());

$response = $this->get('/?param=foo');

dump(session()->getId());

$response = $this->get('/?param=foo');

dump(session()->getId());

该问题仅出现在测试环境中，在浏览器中刷新页面时Session ID保持一致。

我的web中间件组为默认配置：

\App\Http\Middleware\EncryptCookies::class,
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
\Illuminate\Session\Middleware\StartSession::class,
\Illuminate\View\Middleware\ShareErrorsFromSession::class,
\App\Http\Middleware\VerifyCsrfToken::class,
\Illuminate\Routing\Middleware\SubstituteBindings::class,

我在Mac上使用Valet运行Laravel应用，PHP为Homebrew提供的php@8.1，无自定义配置。

以下是php -i输出的session配置：

session.auto_start => Off => Off
session.cache_expire => 180 => 180
session.cache_limiter => nocache => nocache
session.cookie_domain => no value => no value
session.cookie_httponly => no value => no value
session.cookie_lifetime => 0 => 0
session.cookie_path => / => /
session.cookie_samesite => no value => no value
session.cookie_secure => 0 => 0
session.gc_divisor => 1000 => 1000
session.gc_maxlifetime => 1440 => 1440
session.gc_probability => 1 => 1
session.lazy_write => On => On
session.name => PHPSESSID => PHPSESSID
session.referer_check => no value => no value
session.save_handler => files => files
session.save_path => no value => no value
session.serialize_handler => php => php
session.sid_bits_per_character => 5 => 5
session.sid_length => 26 => 26
session.upload_progress.cleanup => On => On
session.upload_progress.enabled => On => On
session.upload_progress.freq => 1% => 1%
session.upload_progress.min_freq => 1 => 1
session.upload_progress.name => PHP_SESSION_UPLOAD_PROGRESS => PHP_SESSION_UPLOAD_PROGRESS
session.upload_progress.prefix => upload_progress_ => upload_progress_
session.use_cookies => 1 => 1
session.use_only_cookies => 1 => 1
session.use_strict_mode => 0 => 0
session.use_trans_sid => 0 => 0
session.trans_sid_hosts => no value => no value
session.trans_sid_tags => a=href,area=href,frame=src,form= => a=href,area=href,frame=src,form=

我的phpunit.xml文件配置：

<server name="SESSION_DRIVER" value="array"/>

请问是什么原因导致Session每次请求都被重新生成？

原因分析 #

• Session驱动的临时特性：你在phpunit.xml中配置的SESSION_DRIVER=array是内存级临时驱动，Session数据仅存在于当前请求的生命周期内。Laravel功能测试每次发起HTTP请求时，会重新初始化应用容器，之前的Session数据（包括ID）会被完全清空，下一次请求会自动生成新的Session ID。
• 测试请求的上下文隔离：Laravel测试框架默认会为每个HTTP请求创建独立的请求上下文，不会自动携带上一次请求的Session Cookie。而浏览器会自动保存并在后续请求中携带Session Cookie，因此能维持同一个Session ID，测试环境则做不到这一点。

解决办法 #

如果需要在测试的多个请求间保持同一个Session，可以采用以下方案：

• 手动传递Session Cookie：在第一次请求后提取Session Cookie，后续请求主动携带该Cookie：

// 发起第一次请求并获取Session Cookie
$response = $this->get('/?param=foo');
$sessionCookie = $response->headers->getCookies()->first(fn($cookie) => $cookie->getName() === config('session.cookie'));

// 后续请求携带该Cookie以维持Session
$response = $this->withCookie($sessionCookie->getName(), $sessionCookie->getValue())->get('/?param=foo');

• 切换到持久化驱动：将phpunit.xml中的SESSION_DRIVER改为file（与生产环境一致），但需注意在测试完成后清理Session文件，避免影响其他测试用例。
• 初始化Session并手动维护：在测试方法开头调用$this->startSession()，之后可通过session()助手直接操作Session数据，这种方式更适合单请求内的Session验证场景。

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