Laravel Blade模板服务端无法正常渲染,本地运行正常该如何解决?
Laravel 8 部署后Blade模板不解析问题解决方案
按优先级依次排查以下问题:
- Web服务器配置错误
Nginx环境需要确认站点配置中请求已正确转发至public/index.php入口文件,避免直接将Blade模板识别为静态文本返回;Apache环境需要确认已开启mod_rewrite扩展,且项目public目录下的.htaccess文件正常生效。 - 目录权限不足
给项目下storage和bootstrap/cache目录配置Web服务器进程的读写权限,Blade编译后的缓存文件默认存储在storage/framework/views目录下,无写入权限会导致模板无法编译,直接返回原始内容。 - vendor目录跨平台兼容问题
禁止直接上传Windows本地生成的vendor目录到Linux服务器,composer安装依赖时会适配当前操作系统环境,跨平台传输会导致依赖不兼容。请在服务器项目根目录执行以下命令重新生成vendor:composer install --optimize-autoloader --no-dev - 项目缓存未清理
依次执行以下Artisan命令清理原有缓存:
生产环境可额外执行php artisan config:clear php artisan view:clear php artisan route:clear php artisan cache:clearphp artisan config:cache优化配置加载效率。 - 路由逻辑错误
确认路由定义中返回模板时使用view()助手函数,没有直接读取Blade文件原始内容返回的错误写法。
内容的提问来源于stack exchange,提问作者Akın Evrenkaya
相关产品推荐
相关产品推荐

