讲师中心 微信公众号
AI工具推荐 视频效率加速

laravel-admin后台空白?修复前端资源加载

胖明大大_4071

胖明大大_4071

发布时间:2026-08-19 12:01:23

|

785人浏览过

|

来源于php中文网

原创

后台空白最常见原因是public/vendor/admin目录为空或缺失字体文件,需执行php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider" --force强制发布,并检查CSS与字体文件是否存在、APP_URL配置是否正确、Nginx是否配置woff2等字体MIME类型。

laravel-admin后台空白?修复前端资源加载

public/vendor/admin 目录为空或缺失字体文件

这是后台空白最常见原因:资源根本没发布成功,浏览器连 admin.cssfontawesome-webfont.woff2 都 404 了,页面自然白屏。

执行命令强制重新发布:

php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider" --force

然后检查:public/vendor/admin/css/admin.csspublic/vendor/admin/fonts/fontawesome-webfont.woff2 是否真实存在。若仍为空,确认 storagebootstrap/cache 目录有写权限;Linux 下可运行 chmod -R 755 storage bootstrap/cache

APP_URL 配置错误导致静态资源路径错乱

如果 .envAPP_URL 写成 http://localhost,但你实际用域名(如 https://admin.example.com)访问,Laravel 会生成带 http://localhost/vendor/... 的资源链接,浏览器因协议/域名不匹配拒绝加载。

立即学习前端免费学习笔记(深入)”;

必须确保:

前端美化
前端美化

使用此技能可创建独具特色、具备生产级质量的前端界面,设计品质高。当用户要求构建网页组件、页面、产物、海报或应用程序时(例如:网站、落地页、仪表盘、React 组件、HTML/CSS 布局,或对任意 Web UI 进行样式优化与视觉美化),请启用该能力。输出需为富有创意、精雕细琢的代码与 UI 设计,避免千篇一律的 AI 风格。

下载
  • APP_URL 与实际访问地址完全一致(含 https、端口、末尾不加斜杠)
  • 修改后运行 php artisan config:clear,否则缓存的旧配置仍生效
  • 检查页面源码中所有 <link href="..."><script src="..."> 路径是否可直接在浏览器地址栏打开

Nginx 未声明字体 MIME 类型,woff2 返回 404 或 text/plain

即使字体文件存在,Nginx 默认不识别 .woff2 后缀,会返回 Content-Type: text/plain,浏览器直接拒载,控制台报 Failed to decode downloaded fontCORS policy: No 'Access-Control-Allow-Origin' header

在 Nginx server 块内添加:

location ~ \.(woff2?|eot|ttf|otf|svg)$ {
    add_header Access-Control-Allow-Origin *;
    types {
        font/woff woff;
        font/woff2 woff2;
        font/eot eot;
        font/ttf ttf;
        font/svg svg;
    }
}

执行 sudo nginx -s reload,再用浏览器开发者工具的 Network 标签筛选 fonts,确认字体请求返回状态码为 200 且 Content-Typefont/woff2

CDN 资源被拦截或版本失效

laravel-admin 默认通过 CDN 加载部分 JS(如 CKEditor),若网络策略屏蔽外部域名,或 CDN 地址已过期(例如 //cdn.ckeditor.com/4.5.10/... 已下线),就会卡在初始化阶段,页面无报错但空白。

临时禁用 CDN,在 config/admin.php 中设置:

'cdn' => [
    'enable' => false,
],

然后运行 php artisan admin:publish --force 把相关资源本地化。若需保留 CDN,查清具体是哪个 URL 失效(看 Network 面板 pending 的请求),再手动更新 src/Form/Field/Editor.php 等文件里的 $js 数组。

前端资源问题往往不是单点故障,而是链式失效:路径错 → 字体拒载 → CSS 不生效 → JS 初始化失败 → 页面白屏。排查时务必按「网络请求 → 文件存在性 → MIME 类型 → 配置一致性」顺序验证,跳过任一环都可能绕回原点。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2043

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4343

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5470

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

4918

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

683

2024.05.22

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

817

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

795

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2348

2024.04.09

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 179人学习

Composer手册
Composer手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn