Laravel v10.x项目安装laravel/breeze遇依赖冲突，如何解决？

问题详情 #

在Laravel 10.x项目中尝试安装指定版本的laravel/breeze时出现依赖冲突，执行命令及错误如下：

williambrush@Williams-MacBook-Pro LandingPage2 % composer require laravel/breeze:1.9.2 --dev -W
./composer.json has been updated
Running composer update laravel/breeze --with-all-dependencies
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires laravel/breeze 1.9.2 -> satisfiable by laravel/breeze[v1.9.2].
    - laravel/breeze v1.9.2 requires illuminate/support ^8.42|^9.0 -> found illuminate/support[v8.42.0, ..., v8.83.27, v9.0.0, ..., v9.52.16] but these were not loaded, likely because it conflicts with another require.


Installation failed, reverting ./composer.json and ./composer.lock to their original content.

当前项目的composer.json（未包含breeze）：

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The skeleton application for the Laravel framework.",
    "keywords": ["laravel", "framework"],
    "license": "MIT",
    "require": {
        "php": "^8.1",
        "guzzlehttp/guzzle": "^7.2",
        "laravel/framework": "^10.10",
        "laravel/sanctum": "^3.3",
        "laravel/tinker": "^2.8"
    },
    "require-dev": {
        "fakerphp/faker": "^1.9.1",
        "laravel/pint": "^1.0",
        "laravel/sail": "^1.18",
        "mockery/mockery": "^1.4.4",
        "nunomaduro/collision": "^7.0",
        "phpunit/phpunit": "^10.1",
        "spatie/laravel-ignition": "^2.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-update-cmd": [
            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true,
        "allow-plugins": {
            "pestphp/pest-plugin": true,
            "php-http/discovery": true
        }
    },
    "minimum-stability": "stable",
    "prefer-stable": true
}

此前尝试过在Stack Overflow查找方案、删除composer.lock和composer.json重装，均未解决问题，且删除文件导致项目其他功能异常。开发环境为MacOS + Laravel HERD，已全局安装Composer。

核心原因 #

你指定安装的laravel/breeze:1.9.2仅支持Laravel 8.x和9.x版本，而当前项目使用的是Laravel 10.x，两者依赖的illuminate/support版本范围不兼容，直接导致冲突。

illuminate/filesystem是Laravel框架的核心依赖，并非冲突原因，无需移除或修改。

解决方案 #

方案1：自动安装兼容版本 #

执行以下命令，让Composer自动选择适配Laravel 10的Breeze最新稳定版本：

composer require laravel/breeze --dev -W

方案2：指定兼容的具体版本 #

若需指定版本号，可选择1.20.0及以上的Breeze版本（该版本范围支持Laravel 10）：

composer require laravel/breeze:^1.20.0 --dev -W

注意事项 #

• 禁止直接删除composer.json和composer.lock文件，这会破坏项目的依赖结构，引发不可预知的功能异常。
• 若后续仍有依赖问题，可先检查Composer环境再重试：

composer diagnose
composer clear-cache

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