Laravel 5部署到Heroku后环境始终为Local的问题求助

看起来你在Laravel 5里配置环境时遇到了“无论本地还是Heroku都显示Local”的问题，我来帮你一步步排查解决，同时实现HTTP/HTTPS的平滑切换。

一、先搞懂Laravel 5的环境判断逻辑 #

Laravel 5默认通过.env文件里的APP_ENV值来识别当前环境，但有几个关键点要注意：

• 本地开发时，.env文件的配置会直接生效；
• 部署到Heroku时，本地的.env文件不会被上传，Heroku会使用你设置的服务器环境变量；
• 如果之前缓存过配置，新的环境变量或.env修改不会立即生效，必须清除缓存。

二、本地开发环境（dev）配置 #

1. 修改本地.env文件：

   APP_ENV=dev
   APP_DEBUG=true
   APP_URL=http://localhost:8000 # 或者你的本地开发域名
   

2. 清除本地配置缓存（避免旧配置干扰）：

   php artisan config:clear
   php artisan cache:clear
   

3. 验证环境是否生效：可以在路由里加个测试代码，访问后查看输出：

   Route::get('/test-env', function() {
       return '当前环境：' . app()->environment();
   });
   

三、Heroku生产环境（production）配置 #

Heroku不读取本地.env，必须通过Heroku的环境变量来设置：

1. 通过Heroku CLI设置环境变量（如果没装CLI，也可以在Heroku控制台的“Settings”->“Config Vars”里手动添加）：

   heroku config:set APP_ENV=production APP_DEBUG=false APP_URL=https://your-heroku-app-name.herokuapp.com
   

2. 清除Heroku上的配置缓存：

   heroku run php artisan config:clear
   

3. 同样可以用上面的测试路由验证环境是否变成production。

四、实现HTTP/HTTPS的平滑切换 #

在AppServiceProvider.php的boot方法里添加环境判断逻辑，自动切换协议：

<?php

namespace App\Providers;

use Illuminate\Support\Facades\URL;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        // 生产环境强制HTTPS
        if ($this->app->environment('production')) {
            URL::forceScheme('https');
        }
        // 如果需要区分dev和local，也可以扩展判断
        // if ($this->app->environment(['production', 'staging'])) { ... }
    }

    /**
     * Register any application services.
     */
    public function register(): void
    {
        // 这里可以保留你的原有注册逻辑
    }
}

五、排查环境始终显示Local的常见原因 #

1. Heroku环境变量未设置：检查Heroku的Config Vars里是否有APP_ENV=production，如果没有，赶紧添加；
2. 配置缓存未清除：不管本地还是Heroku，修改环境配置后一定要执行config:clear，否则Laravel会用缓存的旧配置；
3. 自定义环境检测逻辑冲突：如果你之前修改过bootstrap/app.php里的环境检测代码，可能覆盖了.env的设置，检查一下有没有类似这样的代码，如果有，调整逻辑确保和APP_ENV一致：

   $app->detectEnvironment(function() {
       // 这里的逻辑可能导致环境始终为Local，需要修改
   });
   

按照这些步骤操作后，应该就能正常区分dev和production环境，并且自动切换HTTP/HTTPS了。

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