Laravel部署至cPanel后无法读取.env文件，求技术解决方案

我之前部署Laravel到cPanel时也踩过几乎一模一样的坑，结合你提到的bootstrap/cache目录缺少config.php这个关键线索，给你几个针对性的排查和解决方向：

1. 核对PHP版本与本地环境一致 #

很多时候本地开发用的是较高版本PHP，但cPanel默认的PHP版本偏低，导致config:cache命令执行失败，无法生成config.php。你可以：

• 登录cPanel，找到「PHP选择器」（PHP Selector）
• 切换到和本地开发环境完全相同的PHP版本（比如本地是8.1，服务器也设成8.1）
• 重新执行php artisan config:cache

2. 修正.env文件的权限与所有者 #

虽然你设置了755权限，但cPanel主机对文件权限的要求更严格：

• .env不需要执行权限，建议改成644（更安全且符合多数主机规则）
• 确保.env文件的所有者和你的网站运行用户一致（可以在cPanel文件管理器里查看public_html文件夹的所有者，把.env的所有者改成相同的）

3. 手动生成并写入APP_KEY #

有时候自动生成的APP_KEY在上传过程中丢失，或者.env格式有问题：

• 执行命令：php artisan key:generate --show
• 把输出的密钥（格式类似base64:xxxxxxxxxxxxxxxxxxxxxxxxx）手动复制粘贴到.env文件的APP_KEY字段中
• 执行php artisan cache:clear和php artisan config:clear

4. 检查bootstrap/cache目录的权限 #

这个目录需要服务器有写入权限才能生成缓存文件：

• 确保bootstrap/cache的权限是755
• 同样要确认目录所有者和网站运行用户一致
• 如果之前有缓存失败的情况，先删除目录里的所有文件，再重新执行php artisan config:cache

5. 调整public/index.php的路径（当所有文件放在public_html时） #

如果你把整个Laravel项目都放在public_html目录下，需要修改public/index.php里的路径引用：

• 找到这行：

  require __DIR__.'/../vendor/autoload.php';
  

  修改为：

  require __DIR__.'/vendor/autoload.php';
  

• 再找到这行：

  $app = require_once __DIR__.'/../bootstrap/app.php';
  

  修改为：

  $app = require_once __DIR__.'/bootstrap/app.php';
  

• 保存后重新清缓存

6. 查看服务器错误日志找细节 #

cPanel的「错误日志」功能能帮你找到更具体的报错：

• 登录cPanel，找到「错误日志」选项
• 查看最近的报错信息，比如是否缺少openssl扩展（Laravel生成APP_KEY依赖这个扩展）、是否有文件权限不足的提示，这些细节能快速定位问题

如果以上方法都试过还是不行，你可以尝试手动创建一个空的config.php文件放在bootstrap/cache目录，设置权限为755，然后再执行php artisan config:cache，看是否能正常生成缓存内容。

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