90%的Laravel启动失败、空白页、403、数据库连不上问题源于环境配置偏差：一、PHP版本（L11需≥8.2，L10需≥8.1）及必需扩展（mbstring、openssl、pdo等）未正确启用；二、.env文件缺失或APP_KEY未生成；三、storage与bootstrap/cache目录权限不足；四、数据库驱动未加载或连接参数错位。
部署 Laravel 项目时，90% 的“启动失败”“空白页”“403”“数据库连不上”问题，其实和 Laravel 本身无关，而是环境配置环节出了偏差。关键不是重装，而是按顺序查准、改对、验证到位。
PHP 版本与扩展没对齐
Laravel 11 要求 PHP ≥ 8.2，Laravel 10 要求 ≥ 8.1；低于版本，连 php -v 都可能报错。不能只看“有 PHP”，还要确认必需扩展已启用：
- 运行
php -m，检查列表中是否含：mbstring、openssl、pdo、tokenizer、xml、curl、ctype、json - Windows 用户重点检查
php.ini：取消注释extension=mbstring、extension=openssl、extension=pdo_mysql等行 - 改完
php.ini后，必须重启 Web 服务（如 Apache）或终端——否则修改不生效 - 别用
--ignore-platform-reqs掩盖问题，它会让项目“看似创建成功”，但后续 Session、JSON 解析、路由会随机崩溃
Composer 版本与镜像配置错误
Laravel 11 强制依赖 Composer 3.x，用 2.x 执行 create-project 会卡在 “Resolving dependencies” 或报错 “Your requirements could not be resolved”：
- 运行
composer --version，输出必须是 3.x（如3.5.6） - 国内用户务必配置镜像源：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 安装时加
--prefer-dist避免 Git 克隆超时：composer create-project laravel/laravel myapp --no-interaction --prefer-dist - 内存不足？临时提升即可：
php -d memory_limit=-1 composer create-project
.env 文件缺失或 APP_KEY 未生成
浏览器打开显示 403、空白页、index.php 源码，或登录/数据库操作无声失败，大概率是这两项漏了：
- 进项目根目录，确认存在
.env；没有就复制：copy .env.example .env（Windows）或cp .env.example .env（WSL/Linux/macOS） - 立刻执行：
php artisan key:generate——缺这步，所有加密、CSRF、Session 全失效 - 检查
.env中APP_KEY是否为base64:xxxx格式、长度约 44 字符；若为SomeRandomString或为空，必须重生成 - Docker 或 CI 环境容易漏掉这步——
php artisan key:generate必须在容器启动前执行，不能只写在 Dockerfile 的COPY后面
目录权限与缓存未设置
storage 和 bootstrap/cache 目录权限不足，会导致日志写入失败、配置无法缓存、视图编译异常：
- Windows 用户需为
storage和bootstrap/cache设置“完全控制”权限（右键 → 属性 → 安全 → 编辑 → 勾选“完全控制”） - Linux/macOS 运行：
chmod -R 775 storage bootstrap/cache（开发环境），生产环境建议更严格（如755） - 部署后务必运行：
php artisan config:cache（生成配置缓存）、php artisan route:cache（路由稳定后启用）、php artisan storage:link（确保 public/storage 可访问上传文件） - 注意：
config:cache和route:cache仅适用于 production 环境，本地开发请勿执行
数据库驱动未启用或连接参数错位
报错 SQLSTATE[HY000] [2002] Connection refused 或更隐蔽的 Driver not supported，往往不是数据库地址错了，而是 PHP 根本没加载 MySQL 驱动：
- 运行
php -m | grep pdo，确认输出含pdo_mysql；没有就装：Ubuntu 用sudo apt install php-mysql，Mac M1 用pecl install pdo_mysql - 改完扩展要重启 PHP-FPM 或 Web 服务：
sudo systemctl restart php*-fpm（光 reload 不够） - 别信
phpinfo()页面里显示的“Loaded Modules”——它可能和 CLI 用的不是同一份配置，用php -i | grep 'pdo_mysql'更准 - 核对
.env中DB_CONNECTION=mysql、DB_HOST=127.0.0.1、DB_PORT=3306、DB_DATABASE、DB_USERNAME、DB_PASSWORD是否全部匹配真实数据库信息
