Laravel会话值随机丢失：添加save()方法后问题解决

问题场景 #

项目从 Laravel 7 逐步升级到 10 后，出现会话值随机丢失的情况：

• 在控制器的 some_view 方法中存入会话值：

// 控制器代码
public function some_view(Request $request)
{
    $request->session()->put('key1', 'value1');

    // ... 其他业务代码 ...

    return view(...);
}

• 在其他逻辑（如另一控制器方法、邮件类构造函数）中获取该会话值时，key1 经常返回 null：

// 邮件类代码
class SomeEmail extends Mailable
{
    public $some_value;

    public function __construct() {
        $this->some_value = session('key1'); // 频繁为 null，但并非一直如此
    }
}

临时解决方法 #

参考旧版帖子的建议，在存入会话值后手动调用 save() 方法，问题消失：

public function some_view(Request $request)
{
    $request->session()->put('key1', 'value1');
    $request->session()->save(); // 手动触发会话保存

    // ... 其他业务代码 ...

    return view(...);
}

问题根源与版本升级的关联 #

• 会话自动保存的逻辑变化
  Laravel 的会话系统默认会在响应发送给客户端前，自动检测会话数据是否被修改（即"脏标记"），如果有修改才会将数据写入存储。但从 Laravel 7 到 10 的版本迭代中，会话中间件的自动保存逻辑、脏标记的判定规则有细微调整。如果升级过程中，项目的中间件顺序、会话配置（config/session.php）没有完全同步到新版本要求，可能导致 put 操作没有正确触发脏标记，进而跳过自动保存，导致会话数据未写入存储，后续请求/上下文无法读取。

• 手动 save() 的作用
  save() 方法是会话系统的底层方法，作用是强制将会话内存中的数据写入存储，忽略脏标记的判定。虽然官方文档未主动提及（因为默认自动保存逻辑已经覆盖绝大多数场景），但它一直保留在核心代码中用于边缘场景的兜底。添加该方法后，相当于绕开了自动保存的判定逻辑，确保数据被持久化。

• 版本升级的潜在遗留问题
  逐步升级过程中，可能存在配置文件的遗留差异：比如 Laravel 8 开始对会话驱动的配置项做了调整，或者会话中间件的注册方式变化，如果项目没有完全合并新版本的配置文件，可能导致会话存储的读写逻辑异常，出现随机丢失的情况。另外，部分自定义中间件如果在会话中间件之后修改了会话数据但未正确标记，也可能干扰自动保存逻辑。

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