Yii2会话数据丢失排查：设置basket_id后获取值为null

问题场景 #

通过setSessionId函数设置会话值basket_id，在createSessionID函数内用var_dump验证值已成功存入会话，但调用独立的getSessionID函数时，basket_id却返回null。

相关代码 #

设置会话的函数

public static function setSessionId($sessionId): void
{
    Yii::$app->session->set("basket_id", $sessionId);
}

创建并设置会话ID的函数

public static function createSessionID(): ?Itinerary
{
    $post = new Post();
    $itinerary = $post->postItinerary();

    if ($itinerary && $itinerary->session) {
        self::setSessionId($itinerary->session);

        var_dump($itinerary->session);
        var_dump(Yii::$app->session->get("basket_id"));

        $b = new self;
        $b->setAttributes(
            [
                "session_id" => $itinerary->session,
            ]
        );
        $b->save();
    }

    return $itinerary;
}

获取会话ID的函数

public static function getSessionID()
{
    var_dump(Yii::$app->session->get("basket_id"));

    $basketId_session = Yii::$app->session->get("basket_id");

    $session_id = false;

    if (!$session_id && $basketId_session) {
        $session_id = $basketId_session;
    }

    return $session_id;
}

可能的原因及排查方案 #

1. 会话上下文不一致或未启动 #

Yii会话需在请求生命周期内正确启动，若getSessionID所在请求未初始化会话，将读取不到之前的值：

• 检查getSessionID调用时，是否已通过Yii::$app->session->open()启动会话（Yii通常自动启动，但CLI命令、异步任务等场景可能不会自动触发）。
• 确认两次请求的会话ID一致：查看请求Cookie中是否携带正确的PHPSESSID（或Yii配置的会话Cookie名），Cookie丢失或篡改会导致生成新的空会话。

2. 会话存储配置异常 #

若会话存储介质（文件、Redis、数据库）配置错误，会导致值无法持久化：

• 文件存储场景：检查Yii配置components.session.savePath对应的目录是否存在且有读写权限，无权限则会话数据无法保存。
• 第三方存储场景：确认Redis、数据库服务正常运行，连接参数配置正确，验证数据是否真的写入存储介质。

3. 请求时序问题 #

若createSessionID在响应发送后才设置会话值，修改不会被持久化：

• 检查createSessionID的调用时机，是否在response->send()之后执行。Yii会在响应发送前自动保存会话，发送后设置的值不会被写入。
• 可在setSessionId函数末尾手动调用Yii::$app->session->save()，强制写入会话数据。

4. 会话垃圾回收触发 #

PHP会话垃圾回收可能概率性清理未过期会话，若会话文件权限或修改时间异常，可能被误清理：

• 检查PHP配置session.gc_probability、session.gc_divisor、session.gc_maxlifetime，确认会话过期时间设置合理。
• 查看会话存储目录下的文件，确认设置会话后的文件是否存在，且内容包含basket_id的值。

5. 会话组件被覆盖 #

确认Yii::$app->session在两个函数中指向同一组件实例：

• 排查是否有代码在中间环节替换了session组件，比如通过Yii::$app->set('session', new CustomSession())。
• 确认未使用自定义会话组件导致数据隔离。

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