Laravel中编写API功能测试可通过Artisan命令生成测试类，使用HTTP测试客户端模拟请求并断言响应状态、数据结构及数据库变化，支持认证用户访问和中间件控制，能有效验证正常与错误场景。

在Laravel中为API端点编写功能测试非常直观，框架提供了强大的测试工具和HTTP测试客户端，让你可以轻松模拟请求、检查响应以及验证数据库状态。下面介绍如何正确地为API端点编写功能测试。

创建API功能测试类

使用Artisan命令生成一个功能测试文件：

该命令会在 tests/Feature 目录下创建测试类。建议将API相关的测试放在这个目录中。

模拟HTTP请求并断言响应

Laravel的测试类可以通过 $this->get()、$this->post()、$this->put() 和 $this->delete() 方法模拟各种HTTP请求。

例如，测试一个获取用户列表的API端点：

public function test_can_get_all_users()
{
    // 创建一些测试数据
    $users = User::factory()->count(3)->create();

    $response = $this->get('/api/users');

    $response->assertStatus(200)
             ->assertJsonCount(3)
             ->assertJsonStructure([
                 '*' => ['id', 'name', 'email']
             ]);
}

测试创建用户的POST请求：

public function test_can_create_user()
{
    $userData = [
        'name' => 'John Doe',
        'email' => 'john@example.com',
        'password' => 'secret123'
    ];

    $response = $this->post('/api/users', $userData);

    $response->assertStatus(201)
             ->assertJsonPath('data.name', 'John Doe');

    $this->assertDatabaseHas('users', [
        'email' => 'john@example.com'
    ]);
}

处理认证和中间件

如果API需要用户登录（如使用 Sanctum 或 Passport），可以在测试中通过 $this->actingAs() 方法模拟认证用户：

use Illuminate\Foundation\Testing\WithFaker;
use App\Models\User;

public function test_authenticated_user_can_access_profile()
{
    $user = User::factory()->create();

    $response = $this->actingAs($user, 'sanctum')
                     ->get('/api/user/profile');

    $response->assertStatus(200);
}

若想在功能测试中跳过中间件（如防止速率限制干扰测试），可在测试类中设置：

protected function setUp(): void
{
    parent::setUp();
    $this->withoutMiddleware();
}

或者只关闭特定中间件：

$this->withoutMiddleware([ThrottleRequests::class]);

验证错误响应和表单验证

测试API在输入无效时是否返回正确的422状态码和错误信息：

public function test_validation_fails_for_invalid_data()
{
    $response = $this->post('/api/users', [
        'name' => '',
        'email' => 'not-an-email',
        'password' => '123'
    ]);

    $response->assertStatus(422)
             ->assertJsonValidationErrors(['name', 'email', 'password']);
}