为何无法将Laravel项目从production模式切换至development模式？

我来帮你排查这个让人头疼的问题——Laravel的环境模式有时候会因为缓存优先级、配置加载顺序或者外部变量覆盖的问题，出现改了.env却不生效的情况，咱们一步步来解决：

• 先确认.env文件的修改真的保存了
  有时候我们以为改了文件，但可能没保存成功，或者编辑了错误的文件。直接用命令查看当前项目根目录下的.env内容：

  # Linux/Mac
  cat .env
  # Windows（命令提示符）
  type .env
  

  确认APP_ENV=development这一行确实存在，没有被注释或者拼写错误（比如写成了APP_ENVIROMENT）。

• 调整缓存操作的顺序
  你之前执行的命令顺序有个小问题：php artisan config:cache会把所有配置打包成一个缓存文件，这个文件的优先级远高于.env。正确的操作顺序应该是：

  1. 修改并保存.env文件
  2. 清除旧的配置缓存：php artisan config:clear
  3. 清除路由缓存（可选但建议）：php artisan route:clear
  4. 清除视图缓存：php artisan view:clear
  5. （如果需要）重新缓存配置：php artisan config:cache
     注意：如果你的项目处于开发环境，其实可以不用执行config:cache——开发环境频繁改配置，缓存反而会拖后腿。

• 检查是否有系统环境变量覆盖了.env配置
  Laravel会优先读取系统层面的环境变量，而不是.env文件里的内容。比如：

  • 如果是Apache服务器，检查配置里有没有SetEnv APP_ENV production这样的设置
  • 如果是Nginx，看fastcgi_param里有没有APP_ENV production
  • 如果用了Docker，检查docker-compose.yml或者环境变量配置里有没有设置APP_ENV
    这些外部环境变量会直接覆盖.env里的配置，所以要确保它们没有强制设置成production。

• 验证配置加载逻辑
  打开项目根目录下的bootstrap/app.php，检查有没有这行代码：

  $app->loadEnvironmentFrom('.env');
  

  如果这行被注释掉了，Laravel就不会加载你的.env文件，自然不会生效。把注释去掉即可。

• 检查缓存文件的权限
  如果你用不同的用户执行Artisan命令（比如用root，而网站运行在www-data用户下），缓存文件的权限可能会导致网站无法读取新的缓存。可以执行以下命令修复权限：

  chown -R www-data:www-data storage bootstrap/cache
  chmod -R 775 storage bootstrap/cache
  

  替换www-data为你网站运行的实际用户。

• 刷新OPcache（如果开启了的话）
  如果你的PHP开启了OPcache扩展，它可能缓存了Laravel的配置文件，导致新的配置无法生效。这时候需要重启你的PHP-FPM服务或者Web服务器（比如Apache/Nginx），让OPcache刷新缓存。

按照上面的步骤排查，应该就能把环境模式切换到development了。

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