laravel 10安装后500错误通常源于环境配置阻断，需依次检查：php≥8.1及openssl/pdo/mbstring等扩展是否启用；nginx/apache重写规则是否正确（如try_files配置）；开启error_reporting和app_debug=true查看真实报错；确认storage与bootstrap/cache可写、.env格式正确且无bom。
Laravel 10 安装后页面直接显示 500 错误，通常不是代码逻辑问题，而是环境或配置层面的“硬性阻断”，导致框架甚至没机会启动——它卡在了比 PHP 异常更早的阶段。
检查 PHP 和扩展是否就绪
Laravel 10 要求 PHP ≥ 8.1，且必须启用关键扩展：openssl、pdo、mbstring、tokenizer、xml、ctype、json、zip。缺任一扩展，index.php 加载时就会触发致命错误，Nginx/Apache 只能返回 500 或空白。
- 运行 php -v 确认版本 ≥ 8.1
- 运行 php -m | grep -E "(openssl|pdo|mbstring|tokenizer)" 检查核心模块是否已加载
- 若用 LNMP 一键包，注意 .user.ini 中的 open_basedir 设置是否误拦了项目路径（常见于改过 root 后未同步更新）
确认 Web 服务器配置正确
Nginx 或 Apache 若未正确转发请求到 Laravel 的入口文件，会导致 500 或直接 404，尤其是重写规则缺失或冲突时。
- Nginx 必须包含 try_files $uri $uri/ /index.php?$query_string;，不能是
=404结尾 - Apache 需开启 mod_rewrite，且项目根目录下 .htaccess 文件未被禁用（检查
AllowOverride None是否误设） - 子目录部署（如
/myapp）时，Nginx 的root和try_files中的路径必须一致，否则路由失败引发 500
查看真实错误来源
500 是“服务器内部错误”的统称，但 Laravel 默认不显示详情。需主动打开错误提示才能定位根本原因：
- 在 public/index.php 开头添加两行：
error_reporting(E_ALL);<br>ini_set('display_errors', '1'); - 同时检查 PHP 错误日志（如
/usr/local/php/var/log/php-fpm.log或storage/logs/laravel.log），里面往往有明确报错，比如 “Class App\Providers\AppServiceProvider not found”（autoload 未生成）或 “failed to open stream: Permission denied”（storage 目录无写权限） - 执行 composer dump-autoload 和 php artisan config:clear，排除自动加载或配置缓存问题
验证基础权限与目录结构
Laravel 运行依赖特定目录可写，且结构不能错位：
-
storage/ 和 bootstrap/cache/ 必须可写（Linux 下常用
chmod -R 775 storage bootstrap/cache） - 确保 public/index.php 是 Web 服务器实际访问入口，而非访问了项目根目录下的 index.php
- 检查 .env 文件是否存在、格式是否正确（无 BOM、键值间用
=、无多余空格），错误的 DB 配置可能在服务启动时就抛出 PDO 异常
