You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Laravel+Breeze搭建Vue&Inertia报错:composer-runtime-api版本不兼容

问题根源

核心问题是你的Composer版本过低,导致其提供的composer-runtime-api版本(2.1.0)不满足Laravel 10.8.0要求的^2.2约束。Laravel 10及后续版本要求Composer 2.2或更高版本,该版本才引入了composer-runtime-api 2.2的相关特性。

解决步骤
  1. 强制更新Composer到2.2+版本
    执行以下命令确保Composer更新到符合要求的版本:

    composer self-update --2
    

    (Windows环境建议以管理员权限运行命令;若遇网络问题,可手动下载最新的composer.phar替换本地文件)

  2. 验证Composer版本
    执行命令确认版本达标:

    composer --version
    

    输出应显示2.2.x或更高版本。

  3. 重置项目依赖并重新安装

    • 删除项目目录下的composer.lock文件和vendor文件夹:
      rm -rf composer.lock vendor
      
    • 先安装基础Laravel依赖:
      composer install
      
    • 最后执行Breeze的安装命令:
      php artisan breeze:install vue --ssr
      
补充说明

如果项目使用Laravel Sail(容器化开发环境),所有Composer命令需通过Sail执行,确保容器内的Composer版本更新:

sail composer self-update --2
sail composer install
sail artisan breeze:install vue --ssr

内容的提问来源于stack exchange,提问作者Pieter

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.23 21:10:01