运行Doctrine迁移时提示security.firewalls.api下不存在lexik_jwt配置项

核心原因 #

Unrecognized option "lexik_jwt" under "security.firewalls.api" 报错本质是Symfony安全组件解析配置时，LexikJWTAuthenticationBundle提供的配置扩展未被正常加载，导致系统不识别lexik_jwt配置项。

分步解决方法 #

• 检查Bundle注册状态
  打开config/bundles.php文件，确认存在以下注册代码，缺失则手动添加：

  Lexik\Bundle\JWTAuthenticationBundle\LexikJWTAuthenticationBundle::class => ['all' => true],
  

  新环境搭建、composer自动注册失效、近期代码改动删除注册项是该问题的高频诱因。
• 校验依赖安装完整性
  执行composer show lexik/jwt-authentication-bundle命令，若未返回包信息，说明依赖未安装，执行composer install补全所有依赖即可。
• 适配Symfony安全组件版本
  如果你使用Symfony 5.3及以上版本，必须在security.yaml中开启新版验证器模式，否则lexik_jwt配置无法直接放在firewall层级：

  security:
    enable_authenticator_manager: true
  

  若未开启该配置，旧版guard模式下需要将lexik_jwt配置迁移到guard.authenticators节点下。
• 核对环境配置加载逻辑
  确认执行php bin/console doctrine:migrations:migrate命令时使用的运行环境，检查对应环境的差异化配置（如config/packages/prod/security.yaml）是否存在覆盖规则，导致JWT相关配置未被正常加载。

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