Symfony 6.2.7中MainController无法自动注入SessionInterface问题

无法自动注入服务"App\Controller\MainController"，其构造方法__construct()的参数$session需要Symfony\Component\HttpFoundation\Session\SessionInterface实例，但该类型已被排除在自动注入列表之外。

问题原因 #

SessionInterface是Symfony的请求作用域服务，控制器构造函数在请求处理流程启动前就会被容器实例化，此时会话还未初始化，因此框架禁止了在构造函数中直接注入会话服务。

解决方案 #

方法1：通过RequestStack注入（推荐）

注入RequestStack服务，在需要使用会话的action中动态获取会话实例：

namespace App\Controller;

use App\Entity\ShopCart;
use App\Entity\ShopItem;
use App\Repository\ShopItemRepository;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Component\HttpFoundation\RequestStack;

class MainController extends AbstractController
{
    private RequestStack $requestStack;

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

    // ...保留其他action代码

    #[Route('/shop/cart/add/{id<\d+>}', name: 'shopCartAdd')]
    public function shopCartAdd(ShopItem $shopItem, EntityManagerInterface $entityManager): Response
    {
        // 动态获取会话实例
        $session = $this->requestStack->getSession();
        $sessionId = $session->getId();
        dd($sessionId);
        
        // ...后续业务逻辑
    }
}

方法2：在Action方法中直接注入SessionInterface

action方法在请求处理阶段执行，此时会话已初始化，可直接注入：

// 移除构造函数中关于Session的代码

#[Route('/shop/cart/add/{id<\d+>}', name: 'shopCartAdd')]
public function shopCartAdd(ShopItem $shopItem, EntityManagerInterface $entityManager, SessionInterface $session): Response
{
    $sessionId = $session->getId();
    dd($sessionId);
    
    // ...后续业务逻辑
}

方法3：使用AbstractController内置方法

控制器继承了AbstractController，可直接调用内置的getSession()方法：

#[Route('/shop/cart/add/{id<\d+>}', name: 'shopCartAdd')]
public function shopCartAdd(ShopItem $shopItem, EntityManagerInterface $entityManager): Response
{
    $session = $this->getSession();
    $sessionId = $session->getId();
    dd($sessionId);
    
    // ...后续业务逻辑
}

注意事项 #

• 不要在构造函数中调用$session->start()，Symfony会在会话首次被使用时自动启动，手动启动可能引发请求生命周期相关问题。
• 避免在构造函数中依赖任何请求作用域的服务，这类服务都应在action方法中注入或动态获取。

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