Laravel 5.7如何Mock APP_ENV？单元测试遇BadMethodCallException错误

问题根源 #

1. 业务代码通过env('APP_ENV')判断环境，但测试中Mock的是App::environment()方法，两者无关联，导致Mock完全不生效。
2. MockApp facade后，框架底层会调用App实例的offsetGet方法（用于访问服务容器绑定），但未对该方法设置预期，因此抛出错误。

解决方案 #

方案1：直接设置环境变量（推荐）

无需Mock，在测试方法开头直接修改环境变量：

public function testProductionEnvironmentBehavior()
{
    // 设置APP_ENV为production
    putenv('APP_ENV=production');
    
    // 执行待测试的业务逻辑
    $result = yourBusinessMethod();
    
    $this->assertEquals("This production environment", $result);
}

如果业务代码通过config('app.env')获取环境值，也可以用Laravel配置辅助函数修改：

config(['app.env' => 'production']);

方案2：Mock env辅助函数

若需通过Mock实现，可直接模拟env函数的返回值：

public function testProductionEnvironmentBehavior()
{
    \Mockery::mock('alias:Illuminate\Support\Facades\Env')
        ->shouldReceive('get')
        ->with('APP_ENV')
        ->once()
        ->andReturn('production');
    
    $result = yourBusinessMethod();
    
    $this->assertEquals("This production environment", $result);
}

注意事项 #

• 避免直接MockApp facade，除非明确需要模拟整个应用实例的所有方法调用，否则容易触发未预期的方法调用错误。
• 测试完成后建议恢复环境变量原值，避免影响其他测试用例：

protected function tearDown(): void
{
    putenv('APP_ENV=' . env('APP_ENV'));
    parent::tearDown();
}

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