Laravel Voyager 页面持续加载无响应无法正常使用如何解决

故障表现 #

• 站点无法正常运行，访问目标页面后持续处于加载状态，无内容响应
• 关联截图：
  
  

运行环境信息 #

• PHP版本：8.0.6
• Laravel版本：8.57.0

触发原因 #

• Voyager安装版本与当前Laravel、PHP版本不兼容：Laravel 8对应适配的Voyager版本为1.6.x系列，安装非适配版本会出现静态资源加载、后端逻辑执行异常
• Voyager静态资源未正确发布，前端依赖的CSS、JS文件加载失败
• storage、bootstrap/cache目录权限不足，后端请求处理超时
• 项目自定义路由与Voyager默认后台路由冲突，导致请求进入死循环

解决方案 #

1. 版本兼容修复 #

执行命令查看当前Voyager版本：
composer show tcg/voyager
若版本不属于1.6.x系列，执行命令重装适配版本：

composer remove tcg/voyager
composer require tcg/voyager:1.6.*

2. 重新发布静态资源 #

执行Voyager资源发布命令，强制覆盖旧资源：
php artisan vendor:publish --provider="TCG\Voyager\VoyagerServiceProvider" --force
发布完成后清理项目缓存：

php artisan cache:clear
php artisan view:clear
php artisan route:clear

3. 目录权限配置 #

Linux环境下给项目核心目录配置读写权限：

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

4. 路由冲突修复 #

检查项目routes/web.php中的自定义路由，确认没有使用admin作为前缀（Voyager默认后台路由前缀），如果存在冲突，修改config/voyager.php中的prefix参数，将后台前缀调整为其他值即可。

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