Laravel 11.12.0遇ViteManifestNotFoundException问题求助

问题详情 #

• Laravel版本：11.12.0
• 异常：ViteManifestNotFoundException，触发路径：C:\LARAVEL PROJECT\fowambe1\vendor\laravel\framework\src\Illuminate\Foundation\Vite.php 第728行
• 已尝试操作：执行npm install和npm run build时提示"The specified path was not found"，public/build目录缺失且无法自动生成

排查与解决步骤 #

1. 确认项目目录权限 #

Windows下右键项目根目录（C:\LARAVEL PROJECT\fowambe1），进入「属性」-「安全」，确保当前用户拥有读取、写入、修改权限。权限不足时，添加对应权限后重试操作。

2. 检查Vite配置文件 #

确认项目根目录下存在vite.config.js或vite.config.ts，且配置符合Laravel要求，示例配置：

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/css/app.css',
                'resources/js/app.js',
            ],
            refresh: true,
        }),
    ],
});

若配置文件缺失，从Laravel官方基础模板复制一份到项目根目录。

3. 清理缓存并重新构建 #

打开终端，切换到项目根目录（执行cd C:\LARAVEL PROJECT\fowambe1），依次运行以下命令：

# 删除旧依赖和锁文件
rmdir /s node_modules
del package-lock.json
del yarn.lock

# 重新安装依赖
npm install

# 手动创建目标目录
mkdir public\build

# 执行生产构建
npm run build

4. 处理路径空格问题 #

由于项目路径包含空格（C:\LARAVEL PROJECT），可尝试用引号包裹项目路径执行命令：

npm run build --prefix "C:\LARAVEL PROJECT\fowambe1"

5. 区分开发/生产环境操作 #

• 开发环境：无需生成public/build，直接启动Vite开发服务器即可：

  npm run dev
  

  Laravel会自动代理Vite服务，避免触发缺失manifest的异常。
• 生产环境：必须执行npm run build生成静态文件后再部署。

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