修改资源结构后使用@vite Blade指令抛出异常

AI 小北

2026-4-8

我最近新建了一个Laravel 12项目，自己调整了resources文件夹的结构，现在结构是这样的：

resources
  -admin # 后台管理端的前端代码（SPA）
  --js
  --sass
  --package.json
  --vite.config.js
  -store # 商城前端代码
  -views
  --admin
  ---app.blade.php
  --store
  ---home.blade.php

其中admin部分是一个单页应用（SPA），store部分我还没想好具体的实现方式😅。现在遇到的问题是，当我用Vite启动开发服务器时，admin相关的页面抛出了Vite清单找不到的错误，错误信息如下：

Vite manifest not found at: /var/www/my-store/p...（原错误信息内容被截断）

别着急，这种自定义资源结构导致的Vite路径问题我之前也碰到过，主要是因为Laravel默认的Vite配置是指向根目录的resources/js，咱们改了结构之后得手动调整配置和Blade里的指令调用方式，给你几个具体的解决步骤：

调整admin目录下的vite.config.js配置
因为你把admin的Vite配置单独放在了resources/admin里，得确保这个配置文件正确指向当前目录的入口文件，同时指定编译后的资源输出路径，示例配置如下：

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

export default defineConfig({
  plugins: [
    laravel({
      input: ['resources/admin/js/app.js', 'resources/admin/sass/app.scss'],
      publicDirectory: '../../public/admin', // 指定编译后的资源输出到public/admin目录
      buildDirectory: 'admin', // 对应manifest文件的存储目录
    }),
  ],
  server: {
    origin: 'http://localhost:5173', // 确保开发服务器的地址与Blade模板里的调用地址一致
  },
});

修改Blade模板里的@vite调用方式
在resources/views/admin/app.blade.php中，不能直接使用默认的@vite指令，需要明确指定自定义的Vite配置文件路径，示例代码如下：
```
@vite(['resources/admin/js/app.js', 'resources/admin/sass/app.scss'], 'resources/admin/vite.config.js')
```
这样Blade就会读取你admin目录下的专属Vite配置，而不是项目根目录的默认配置。
启动admin目录的Vite开发服务器
之前如果是在项目根目录执行npm run dev，现在因为admin有独立的package.json，需要进入admin目录单独启动：
```
cd resources/admin
npm install # 第一次启动前先安装依赖
npm run dev
```
这样Vite会基于admin目录的配置启动服务，生成正确的清单文件路径。
兼顾store部分的建议
如果你之后要开发store部分，可以参考admin的结构，给store也单独配置Vite文件和依赖，或者在项目根目录的vite.config.js中配置多入口，避免两个前端模块的资源编译互相干扰。

如果还是遇到问题，可以检查public目录下是否生成了对应的admin文件夹，开发模式下Vite会在内存中维护清单文件，但路径配置错误的话就会出现找不到的情况。

内容来源于stack exchange