You need to enable JavaScript to run this app. cPanel部署Laravel项目访问登录页提示Missing Mix Manifest File如何解决
优惠活动
大模型
产品
解决方案
定价
更多

cPanel部署Laravel项目访问登录页提示Missing Mix Manifest File如何解决

解决cPanel部署Laravel时Missing Mix Manifest File报错

对应报错信息:
Missing Mix Manifest File
The Mix manifest does not exist. (View: /home/****/public_html/resources/views/layouts/guest.blade.php)
Did you forget to run npm install && npm run dev?

这个错误是因为Laravel Mix需要的前端资源编译清单文件未生成,可根据你是否有cPanel终端权限选择对应解决方案:

方案1:拥有cPanel终端权限(推荐操作)

  • 进入cPanel的「终端」功能,切换到Laravel项目根目录(即存放app、bootstrap、package.json等文件的目录,如果你的Laravel核心文件存放在public_html同级目录,执行命令cd /home/你的cPanel用户名/项目根目录名称;如果把整个Laravel项目都放在public_html下,执行命令cd /home/你的cPanel用户名/public_html)
  • 安装前端依赖:执行npm install
  • 编译前端资源,根据环境选对应命令:
    • 开发环境执行npm run dev
    • 生产环境Laravel 9+执行npm run build,Laravel 8及更早版本执行npm run prod
  • 编译完成后确认项目public目录下已生成mix-manifest.json文件,刷新页面即可正常访问

方案2:无cPanel终端权限

如果主机商未开放终端权限,可在本地编译后上传资源:

  • 在本地开发环境的Laravel项目根目录执行上述npm install和对应编译命令
  • 导出本地项目public目录下生成的mix-manifest.json文件,以及编译后的css、js等静态资源文件夹
  • 通过cPanel文件管理器或FTP工具,将上述文件上传到服务器对应Laravel项目的public目录中,覆盖已有文件即可

异常场景修复

如果按上述步骤操作后仍报错,可通过手动指定路径解决:

  • 若你将Laravel的public目录内容直接放在cPanel默认的public_html目录下,需检查config/app.php中的public_path配置是否匹配服务器上的public_html路径
  • 也可以直接在项目根目录的.env文件中新增一行配置,手动指定manifest文件路径:MIX_MANIFEST_PATH=/home/你的cPanel用户名/public_html/mix-manifest.json

内容的提问来源于stack exchange,提问作者Dave Budah

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 03:27:04