Symfony 5.4替换SessionInterface为RequestStack后遇SessionNotFoundException

问题原因 #

替换SessionInterface注入为RequestStack后出现报错，核心原因是：

• 旧的SessionInterface注入是Symfony提供的高层封装，会自动初始化并确保会话存在；
• 而RequestStack->getSession()是更底层的调用，仅当会话已经被启动（比如客户端携带了session cookie，或代码手动启动过会话）时才能获取到，否则直接抛出SessionNotFoundException。

解决方案 #

1. 手动检查并初始化会话（推荐） #

在需要使用会话的代码中，先检查请求是否已有会话，没有则通过SessionFactoryInterface创建并绑定到请求：

首先确保服务中注入RequestStack和SessionFactoryInterface：

use Symfony\Component\HttpFoundation\RequestStack;
use Symfony\Component\HttpFoundation\Session\SessionFactoryInterface;

class YourService
{
    private $requestStack;
    private $sessionFactory;

    public function __construct(RequestStack $requestStack, SessionFactoryInterface $sessionFactory)
    {
        $this->requestStack = $requestStack;
        $this->sessionFactory = $sessionFactory;
    }

    public function yourMethod()
    {
        $request = $this->requestStack->getCurrentRequest();
        if (!$request) {
            // 处理无请求上下文的场景（如命令行）
            throw new \RuntimeException('Cannot access session: no active request');
        }

        // 检查并初始化会话
        if (!$request->hasSession()) {
            $session = $this->sessionFactory->create();
            $request->setSession($session);
        }

        $session = $request->getSession();
        // 后续会话操作...
    }
}

2. 全局开启会话自动启动 #

如果你的项目需要每个请求都自动启动会话，可以修改config/packages/framework.yaml配置：

framework:
    session:
        auto_start: true

⚠️ 注意：自动启动会话会增加每个请求的开销，仅在确实全局需要会话时使用。

3. 控制器中直接从Request获取会话 #

在控制器方法中，可以直接通过注入的Request对象获取会话，Symfony会自动处理初始化：

use Symfony\Component\HttpFoundation\Request;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;

class YourController extends AbstractController
{
    public function yourAction(Request $request)
    {
        $session = $request->getSession();
        // 会话操作...
    }
}

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