Laravel 9+Inertia.js+Vite虚拟主机部署后资源加载失败求助

先确认构建产物是否存在 #

• 检查npm run build执行完成后，项目根目录下的public/build文件夹是否生成，里面必须包含manifest.json以及编译后的js、css文件。如果未生成，重新执行npm run build，留意终端是否出现依赖缺失、配置错误等报错信息。

调整Vite的基础路径配置 #

• 打开项目根目录的vite.config.js，核对base配置项。如果项目部署在子目录下，需设置对应的基础路径：

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import inertia from '@inertiajs/vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: 'resources/js/app.js',
            refresh: true,
        }),
        inertia(),
    ],
    // 根域名部署设为'/'，子目录部署按实际路径填写，比如'/fmcosmetics/'
    base: '/',
});

修改后重新执行npm run build，确保构建产物路径正确。

核对Laravel的配置项 #

• 打开.env文件，确认APP_URL与你的域名一致，例如APP_URL=https://fmcosmetics.ljsharp.com。
• 检查config/app.php中的url配置，需与.env里的APP_URL保持同步。

确认虚拟主机的根目录指向 #

• 虚拟主机的网站根目录必须指向项目的public文件夹！很多主机默认指向项目根目录，会导致Vite无法访问public/build下的资源。需在主机控制面板中将根目录设置为/home/ljsharp1/fmcosmetics.ljsharp.com/public。

清理缓存并重新部署 #

• 执行以下Laravel缓存清理命令：

php artisan cache:clear
php artisan config:clear
php artisan view:clear

• 重新上传public/build文件夹至虚拟主机对应位置，同时确保文件权限正确（文件夹设为755，文件设为644即可）。

检查Inertia根模板的资源引入 #

• 打开resources/views/app.blade.php（或你的Inertia根模板文件），必须使用Laravel提供的@vite指令加载资源，禁止手动编写静态路径：

@vite('resources/js/app.js')

该指令会自动读取manifest文件路径，避免路径匹配错误。

内容的提问来源于stack exchange，提问作者Leslie Joe