Symfony项目初始化时ApiPlatform与Lexik JWT Bundle配置报错

问题重现步骤 #

• 创建新项目：symfony new <my-project>（或composer create-project symfony/skeleton <my-project>）
• 安装ApiPlatform：composer require api
• 安装Lexik JWT Bundle：composer require lexik/jwt-authentication-bundle

执行缓存清理命令时触发错误：

In ArrayNode.php line 327:
!!
!!    Unrecognized option "enabled" under
"lexik_jwt_authentication.api_platform". Available options are
"check_path", "password_path", "username_path".

环境依赖（composer.json） #

{
    "type": "project",
    "license": "proprietary",
    "minimum-stability": "stable",
    "prefer-stable": true,
    "require": {
        "php": ">=8.1",
        "ext-ctype": "*",
        "ext-iconv": "*",
        "api-platform/core": "^3.1",
        "doctrine/doctrine-bundle": "^2.10",
        "doctrine/doctrine-migrations-bundle": "^3.2",
        "doctrine/orm": "^2.16",
        "lexik/jwt-authentication-bundle": "^2.18",
        "nelmio/cors-bundle": "^2.3",
        "phpdocumentor/reflection-docblock": "^5.3",
        "phpstan/phpdoc-parser": "^1.23",
        "symfony/asset": "6.3.*",
        "symfony/console": "6.3.*",
        "symfony/dotenv": "6.3.*",
        "symfony/expression-language": "6.3.*",
        "symfony/flex": "^2",
        "symfony/framework-bundle": "6.3.*",
        "symfony/property-access": "6.3.*",
        "symfony/property-info": "6.3.*",
        "symfony/runtime": "6.3.*",
        "symfony/security-bundle": "6.3.*",
        "symfony/serializer": "6.3.*",
        "symfony/twig-bundle": "6.3.*",
        "symfony/validator": "6.3.*",
        "symfony/yaml": "6.3.*"
    },
    "config": {
        "allow-plugins": {
            "php-http/discovery": true,
            "symfony/flex": true,
            "symfony/runtime": true
        },
        "sort-packages": true
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "App\\Tests\\": "tests/"
        }
    },
    "replace": {
        "symfony/polyfill-ctype": "*",
        "symfony/polyfill-iconv": "*",
        "symfony/polyfill-php72": "*",
        "symfony/polyfill-php73": "*",
        "symfony/polyfill-php74": "*",
        "symfony/polyfill-php80": "*",
        "symfony/polyfill-php81": "*"
    },
    "scripts": {
        "auto-scripts": {
            "cache:clear": "symfony-cmd",
            "assets:install %PUBLIC_DIR%": "symfony-cmd"
        },
        "post-install-cmd": [
            "@auto-scripts"
        ],
        "post-update-cmd": [
            "@auto-scripts"
        ]
    },
    "conflict": {
        "symfony/symfony": "*"
    },
    "extra": {
        "symfony": {
            "allow-contrib": false,
            "require": "6.3.*"
        }
    }
}

问题分析与解决方案 #

错误原因是当前使用的Lexik JWT Bundle（^2.18）的api_platform配置节点不支持enabled选项，但你的配置文件中可能添加了该选项。

解决步骤： #

1. 打开项目中的Lexik JWT配置文件（通常为config/packages/lexik_jwt_authentication.yaml或config/packages/lexik_jwt_authentication.php）
2. 查找并删除包含enabled: true的配置段，示例如下：

   lexik_jwt_authentication:
       api_platform:
           enabled: true # 删除这一行
   

3. 若需要自定义ApiPlatform集成的路径，可配置支持的选项，示例：

   lexik_jwt_authentication:
       api_platform:
           check_path: /api/login_check
           username_path: email
           password_path: password
   

4. 重新执行缓存清理：php bin/console cache:clear

内容的提问来源于stack exchange，提问作者Frédéric Gruwé