如何在Cloudways上启用Inertia？Laravel Inertia Vue3部署故障求助

1. 先确认核心配置是否正确 #

• 检查routes/web.php，确保路由是通过Inertia返回视图，而非Laravel默认的欢迎页路由：

  use Inertia\Inertia;
  
  Route::get('/', function () {
      return Inertia::render('Welcome'); // 这里对应Vue组件的名称
  });
  

  删掉默认的return view('welcome');路由，否则会显示Laravel初始欢迎页。

• 验证resources/views/app.blade.php文件，确保包含@inertia指令，这是Inertia渲染的入口。

2. 生产环境前端资源必须构建 #

登录Cloudways服务器终端，进入项目根目录执行：

npm install && npm run build

Cloudways不会自动构建前端资源，必须手动执行打包，否则浏览器无法加载Vue组件对应的静态文件。

3. 修复文件权限与清理缓存 #

执行以下命令确保权限正确并清理缓存：

# 设置目录权限
chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

# 清理各类缓存
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

4. 检查Cloudways站点基础配置 #

• 在Cloudways站点管理面板，确认文档根目录设置为项目的public文件夹，Laravel应用必须指向public目录才能正常运行。
• 检查Nginx配置（站点设置→应用设置→Nginx配置），确保包含Laravel路由重写规则：

  location / {
      try_files $uri $uri/ /index.php?$query_string;
  }
  

5. 排查前端资源加载问题 #

打开浏览器开发者工具（F12）→网络标签，刷新页面：

• 查看是否有404状态的js/css文件，若存在说明前端资源未正确构建或路径配置错误。
• 若使用Vite，检查vite.config.js的Laravel插件配置，确保输入路径指向resources/js/app.js。

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