Laravel 9.36.2安装Horizon 5.14.1后仪表盘报错求助

1. 清理缓存并重新编译前端资产 #

• 依次执行以下命令，清除系统缓存并重新发布Horizon的前端资源：

  php artisan cache:clear
  php artisan view:clear
  php artisan horizon:publish
  npm run build
  

  若项目使用Laravel Mix而非Vite，将npm run build替换为npm run prod。

2. 强制重新发布Horizon资产 #

• 检查public/vendor/horizon目录是否存在且文件完整，若资产发布异常，执行强制发布命令：

  php artisan horizon:publish --force
  

3. 验证PHP环境兼容性 #

• 确认PHP版本满足要求：Laravel 9需PHP 8.0及以上，Horizon 5.14.1也适配该版本区间。
• 检查必需的PHP扩展是否已安装：BCMath、Ctype、Fileinfo、JSON、Mbstring、OpenSSL、PDO、Tokenizer、XML。

4. 排除缓存服务干扰 #

• 临时禁用CDN（如Cloudflare）或服务器端缓存，然后通过Ctrl+Shift+R强制刷新浏览器页面，验证错误是否消失。

5. 检查环境配置 #

• 确认.env文件中APP_URL配置正确，Horizon依赖该路径加载前端资源。
• 若处于非生产环境，可临时开启APP_DEBUG=true，查看是否有更详细的错误提示。

6. 重装Horizon组件 #

• 若上述方法均无效，尝试卸载并重新安装Horizon：

  composer remove laravel/horizon
  composer require laravel/horizon:5.14.1
  php artisan horizon:install
  php artisan horizon:publish
  

内容的提问来源于stack exchange，提问作者Erik Ieger Dobrychtop