Laravel9部署指南：PHP8.1环境搭建教程

本文详细解析了 Laravel 9 在 PHP 8.1 环境下部署的常见陷阱与精准解决方案：从必须禁用 `opcache.enable_cli=1` 以避免 Artisan 命令卡顿，到定位 `Class 'Illuminate\Foundation\Application' not found` 的根源——autoload 路径错误或 CLI/FPM 的 php.ini 扩展不一致（尤其宝塔需手动启用 fileinfo）；从 Composer 安装因内存不足失败的三重应对策略（调内存、禁插件、换 classmap 模式），到 Nginx 404 的本质原因——root 路径错位、缺失 try_files 规则及 fastcgi_param 配置遗漏；再到极易被忽视却致命的 APP_KEY 必须本地生成，否则引发 Session、密码重置、加密 Cookie 全面静默失效。每一步都直击生产环境真实痛点，帮你避开“看似配置正确实则寸步难行”的部署深坑。

直接上结论：Laravel 9 跑在 PHP 8.1 上没问题，但必须关掉 opcache.enable_cli=1，否则 php artisan 命令会卡住或报错，本地开发和部署都会出问题。

PHP 8.1 环境里 Laravel 9 启动就报 Class 'Illuminate\Foundation\Application' not found

这不是代码坏了，是 autoloader 没加载成功。最常见原因有两个：

• vendor/autoload.php 路径不对 —— 检查 public/index.php 第一行是否仍是 require __DIR__.'/../vendor/autoload.php';，别手误改成 ./vendor/... 或漏了 ../
• PHP CLI 和 FPM 用的不是同一套配置 —— 运行 php --ini 和 php-fpm -i | grep "Loaded Configuration File" 对比两个 php.ini 路径，确保 extension=mbstring、extension=openssl、extension=pdo_mysql 都在两个文件里启用
• 如果用了宝塔，注意它默认给 CLI 关了 fileinfo 扩展 —— Laravel 文件上传、Mime 类型检测会直接失败，必须进宝塔 PHP 设置里手动勾选

部署时 composer install --no-dev --optimize-autoloader 报错

错误常出现在服务器上，尤其是内存小或限制严的环境（比如 1G 内存的轻量服务器）。不是依赖写错了，而是 Composer 进程被 OOM Killer 杀了，或者超时了。

• 先加内存限制：COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader
• 禁用插件减少开销：composer install --no-dev --optimize-autoloader --no-plugins
• 如果还失败，别硬扛 —— 改用 composer install --no-dev --classmap-authoritative，它不生成优化映射，但足够跑起来；等服务稳定后再补 php artisan config:cache
• 绝对不要把本地 vendor/ 打包传上去 —— autoload_classmap.php 里有绝对路径，换机器就失效

Nginx 配置完还是 404，或静态资源打不开

根本原因几乎全是 root 指向错了，或者 try_files 没生效。

• 确认 Nginx 的 root 是 /var/www/myapp/public，不是 /var/www/myapp —— Laravel 的入口只有 public/index.php
• 必须加这行：try_files $uri $uri/ /index.php?$query_string;，缺了它，所有路由和 CSS/JS 都 404
• 如果用了宝塔，伪静态选“Laravel”后，还得手动检查生成的配置 —— 它有时会漏掉 location ~ \.php$ 块里的 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;，导致 PHP 脚本找不到
• storage/ 和 bootstrap/cache/ 目录权限必须是 775 且属组为 www-data（Ubuntu）或 www（宝塔），否则日志写不进去、缓存生成失败

最容易被忽略的一点：APP_KEY 必须用 php artisan key:generate 生成，不能抄别人项目里的，也不能手输。哪怕只错一个字符，Session 就全空，密码重置链接 404，加密 Cookie 全失效 —— 这类问题不会报错，只会静默失败。

终于介绍完啦！小伙伴们，这篇关于《Laravel9部署指南：PHP8.1环境搭建教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！