使用Security::login编程登录后JWT Cookie未设置的问题排查

问题根源 #

Symfony\Bundle\SecurityBundle\Security::login() 仅完成用户身份认证的核心逻辑：生成认证令牌并将其存入安全上下文，但不会触发防火墙配置中json_login对应的认证成功处理器（lexik_jwt_authentication.handler.authentication_success）。

通过/api/login/check登录时，走的是完整的json_login HTTP请求流程，Lexik JWT Bundle会自动调用该成功处理器，生成JWT并根据配置设置Cookie。而编程式登录绕过了这个HTTP请求处理链，导致Cookie设置逻辑未被触发。

解决方案 #

方案1：手动调用认证成功处理器 #

在编程式登录完成后，手动调用Lexik的认证成功处理器，生成JWT并将Cookie附加到响应中。

示例代码（控制器中）：

use Lexik\Bundle\JWTAuthenticationBundle\Security\Http\Authentication\AuthenticationSuccessHandler;
use Symfony\Component\HttpFoundation\Response;

// 完成编程式登录
$token = $this->security->login($user, 'json_login', 'api');

// 获取JWT认证成功处理器
$successHandler = $this->container->get(AuthenticationSuccessHandler::class);
// 生成包含JWT Cookie的响应
$jwtResponse = $successHandler->onAuthenticationSuccess($this->requestStack->getCurrentRequest(), $token);

// 如果已有响应实例，将Cookie附加到当前响应
$response = new Response();
foreach ($jwtResponse->headers->getCookies() as $cookie) {
    $response->headers->setCookie($cookie);
}

return $response;

方案2：通过事件监听统一处理 #

监听Symfony的AuthenticationSuccessEvent事件，只要是api防火墙下的json_login认证成功，就自动生成JWT并设置Cookie。这种方式可以统一处理所有认证场景（包括HTTP登录和编程式登录）。

1. 创建事件订阅器：

use Lexik\Bundle\JWTAuthenticationBundle\Cookie\CookieProvider;
use Lexik\Bundle\JWTAuthenticationBundle\Services\JWTTokenManagerInterface;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\HttpFoundation\RequestStack;
use Symfony\Component\Security\Core\Event\AuthenticationSuccessEvent;

class JwtCookieSubscriber implements EventSubscriberInterface
{
    public function __construct(
        private JWTTokenManagerInterface $jwtManager,
        private CookieProvider $cookieProvider,
        private RequestStack $requestStack
    ) {}

    public static function getSubscribedEvents(): array
    {
        return [
            AuthenticationSuccessEvent::class => 'onAuthenticationSuccess',
        ];
    }

    public function onAuthenticationSuccess(AuthenticationSuccessEvent $event): void
    {
        $authToken = $event->getAuthenticationToken();
        
        // 仅处理api防火墙下的json_login认证
        if ($authToken->getFirewallName() !== 'api' || $authToken->getProviderKey() !== 'json_login') {
            return;
        }

        $request = $this->requestStack->getCurrentRequest();
        if (!$request) {
            return;
        }

        // 生成JWT并创建Cookie
        $jwt = $this->jwtManager->create($authToken->getUser());
        $cookie = $this->cookieProvider->createCookie($jwt);
        
        // 将Cookie附加到当前响应
        $response = $request->attributes->get('_response');
        if ($response) {
            $response->headers->setCookie($cookie);
        }
    }
}

2. 注册订阅器（在services.yaml中）：

services:
    App\EventSubscriber\JwtCookieSubscriber:
        arguments:
            $jwtManager: '@lexik_jwt_authentication.jwt_manager'
            $cookieProvider: '@lexik_jwt_authentication.cookie_provider'
            $requestStack: '@request_stack'
        tags:
            - { name: kernel.event_subscriber }

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