如何Mock Laravel Eloquent的save()方法以返回false？

针对你遇到的问题——想测试TeamController里$team->save()返回false时的核心逻辑，但又不想写杂乱的Mock代码，我给你几个实用且干净的方案：

方案1：利用模型验证规则触发save失败（最自然的场景） #

如果你的Team模型本身有验证规则（比如name字段必填、唯一等），那完全可以不用Mock，直接构造不满足验证条件的请求，让save()自然返回false：

示例代码： #

假设Team模型的验证规则是这样的：

// app/Models/Team.php
public static function rules() {
    return [
        'name' => 'required|unique:teams|min:3',
    ];
}

那测试时可以发送一个不符合规则的请求：

// 测试方法
public function test_create_team_fails_when_save_returns_false() {
    // 发送一个没有name参数的请求，或者重复的name
    $response = $this->post('/teams', []);

    // 断言你的核心逻辑被执行，比如返回错误JSON
    $response->assertJson([
        'success' => false,
        'message' => '创建团队失败'
    ]);
}

这种方式完全贴合真实业务场景，不需要任何Mock，代码简洁且符合测试的"行为驱动"思路。

方案2：用Mockery精准Mock save()方法（适合非验证类失败场景） #

如果你需要测试的是数据库层面的失败（比如连接错误、权限问题）这类无法通过验证触发的场景，可以用Mockery优雅地MockTeam模型的save()方法，且不会污染其他逻辑：

示例代码： #

use App\Models\Team;
use Mockery;

public function test_create_team_handles_save_failure() {
    // 创建一个Team模型的部分Mock，只覆盖save方法，保留其他逻辑
    $teamMock = Mockery::mock(Team::class)->makePartial();
    // 指定save方法调用一次并返回false
    $teamMock->shouldReceive('save')->once()->andReturn(false);

    // 把Mock实例绑定到Laravel容器，让控制器实例化时用这个Mock
    $this->app->instance(Team::class, $teamMock);

    // 发送合法的请求（因为我们要测试的是save失败，不是验证失败）
    $response = $this->post('/teams', ['name' => 'Test Team']);

    // 断言你的核心错误处理逻辑被执行，比如日志记录、错误响应等
    $response->assertStatus(500);
    $this->assertDatabaseMissing('teams', ['name' => 'Test Team']);
}

makePartial()是关键，它让我们只修改需要Mock的方法，其他模型方法保持原样，避免写冗余的Mock代码。

方案3：创建测试专用模型子类（无Mock依赖的方案） #

如果你不想用Mockery这类Mock工具，可以创建一个测试专用的Team子类，重写save()方法返回false，然后通过容器绑定让控制器使用这个子类：

示例代码： #

首先在测试目录下创建测试模型：

// tests/Models/TestTeam.php
namespace Tests\Models;

use App\Models\Team;

class TestTeam extends Team {
    // 重写save方法，强制返回false
    public function save(array $options = []): bool {
        return false;
    }
}

然后在测试方法中绑定：

use Tests\Models\TestTeam;
use App\Models\Team;

public function test_create_team_handles_save_failure() {
    // 绑定Team类到测试子类
    $this->app->bind(Team::class, TestTeam::class);

    // 发送请求
    $response = $this->post('/teams', ['name' => 'Test Team']);

    // 断言错误逻辑执行
    $response->assertJson(['success' => false]);
}

这种方案完全依赖Laravel的容器机制，没有第三方Mock工具依赖，适合对Mock工具不太熟悉的开发者。

总结 #

• 如果是验证失败导致的save()返回false，优先用方案1，最贴近真实业务；
• 如果是数据库异常等非验证场景，用方案2更灵活；
• 不想用Mock工具的话，方案3是个干净的替代方案。

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