Laravel Breeze报错：找不到匹配版本的@tanstack/virtual-core@3.10.0

问题背景 #

执行Laravel Breeze安装流程：

composer create-project laravel/laravel:^11.0 app
cd app
composer require laravel/breeze --dev
php artisan breeze:install

触发npm错误：

npm ERR! code ETARGET
npm ERR! notarget No matching version found for @tanstack/virtual-core@3.10.0.
npm ERR! notarget In most cases you or one of your dependencies are requesting
npm ERR! notarget a package version that doesn't exist.

问题根源是@headlessui/react依赖了未发布的@tanstack/virtual-core@3.10.0版本。

解决方案 #

1. 强制指定兼容的@tanstack/virtual-core版本 #

在项目根目录的package.json中添加overrides字段，强制npm安装存在的兼容稳定版：

{
  // ... 其他package.json原有内容
  "overrides": {
    "@tanstack/virtual-core": "3.9.1"
  }
}

保存文件后执行：

npm install

2. 更新@headlessui/react到最新版本 #

旧版@headlessui/react存在依赖版本错误，直接更新到最新版即可修复：

npm install @headlessui/react@latest

更新完成后重新执行php artisan breeze:install（若之前安装流程中断）。

3. 清除npm缓存并重装依赖 #

如果是缓存导致的版本查找异常，执行以下命令重置依赖环境：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

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