Laravel项目上传服务器后Blade函数与路由失效问题求助

1. 确认服务器Web根目录指向public文件夹 #

这是核心问题所在。Laravel的请求入口是public/index.php，服务器必须将网站根目录设置为项目的public文件夹，而非项目根目录：

• Apache环境：修改虚拟主机配置，将DocumentRoot指向/path/to/your/laravel-project/public，同时在<Directory "/path/to/your/laravel-project/public">区块中开启AllowOverride All以支持URL重写。
• Nginx环境：配置文件中root项需指向/path/to/your/laravel-project/public，并确保包含规则try_files $uri $uri/ /index.php?$query_string;。

2. 修正public/index.php的路径配置 #

若之前修改过该文件，确保以下两行路径正确无误：

require __DIR__.'/../vendor/autoload.php';
$app = require_once __DIR__.'/../bootstrap/app.php';

这两行负责加载Laravel核心依赖与启动应用，路径错误会直接导致框架无法初始化，进而无法解析Blade语法与路由。

3. 修复目录权限 #

Laravel需要storage/和bootstrap/cache/目录具备写入权限，否则无法生成Blade编译文件、缓存文件等：

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache # 根据服务器运行用户调整，比如部分环境用apache或nginx用户

4. 清除Laravel缓存 #

本地缓存上传至服务器后可能引发冲突，执行以下命令清理缓存：

php artisan cache:clear
php artisan config:clear
php artisan view:clear

若无命令行权限，可手动删除storage/framework/cache/、storage/framework/views/、bootstrap/cache/下的所有文件。

5. 验证PHP环境兼容性 #

确保服务器PHP版本符合当前Laravel版本要求（如Laravel 10需PHP 8.1+），且启用了mbstring、xml、ctype、json等必要扩展。

6. 禁止直接访问views目录文件 #

直接访问ServerName/resources/views/welcome.blade.php属于错误操作，Laravel视图必须通过路由/控制器由框架解析后输出，正确方式是访问配置的路由（如默认的/路径），由index.php转发请求。

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