如何在SiteGround服务器运行npm run dev解决Laravel的Vite清单缺失错误

一、无需服务器操作的最简方案（推荐新手） #

• 打开本地VS Code，进入你的Laravel项目根目录
• 执行npm install确保前端依赖安装完整（如果之前装过可跳过）
• 运行生产环境编译命令：npm run build，这会在本地生成public/build文件夹和public/build/manifest.json文件
• 将本地生成的public/build文件夹完整上传到SiteGround服务器对应项目的public目录下
• 刷新网站，错误即可消除

二、在SiteGround服务器上操作的简单方法 #

SiteGround提供网页端终端，无需配置SSH密钥：

• 登录SiteGround后台，进入目标站点的「Site Tools」
• 找到「Devs」分类下的「SSH Terminal」，打开网页终端
• 进入你的Laravel项目根目录（通常是public_html或你指定的子目录，比如public_html/laravel-project）
• 依次执行以下命令：
  1. npm install（首次运行需安装依赖，耗时约1-3分钟）
  2. npm run build（编译前端资源，生成所需的manifest文件）
• 完成后刷新网站即可

三、错误原因说明 #

• Laravel 9及以上版本默认使用Vite管理前端资源，生产环境必须先编译资源生成manifest.json文件，该文件用于映射编译后的静态资源路径
• 若直接上传本地未编译的项目文件，服务器缺少public/build目录及manifest.json，就会触发此错误
• 注意：npm run dev是本地开发用的热重载命令，生产环境必须用npm run build编译生产版本资源

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