Consumer-driven contract testing là gì?

Question

Accepted Answer

**Contract testing** xác minh rằng hai service đồng thuận về API của chúng **mà không** cần chạy chúng cùng nhau trong một integration test đầy đủ. Trong **consumer-driven contracts (CDC)**, consumer định nghĩa những gì nó cần, và provider xác minh rằng nó có thể cung cấp điều đó.

## Vấn đề

Các test end-to-end đầy đủ xuyên nhiều service thì chậm, hay chập chờn (flaky), và khó chạy trên mỗi commit. Contract test bắt các thay đổi API gây phá vỡ sớm, một cách cô lập.

## CDC hoạt động ra sao (ví dụ Pact)

```text
1. Consumer viết các kỳ vọng ─▶ sinh ra một CONTRACT (file Pact)
2. Contract được publish lên một broker
3. Provider chạy contract đối chiếu với chính mình trong pipeline của nó
4. Build của provider THẤT BẠI nếu nó sẽ phá vỡ consumer
```

## Ví dụ phía consumer

```js
// consumer khai báo chính xác những gì nó kỳ vọng từ provider
provider.given('order 42 exists')
  .uponReceiving('a request for order 42')
  .withRequest({ method: 'GET', path: '/orders/42' })
  .willRespondWith({
    status: 200,
    body: { id: '42', total: 99.5 } // hình dạng mà consumer dựa vào
  });
```

CI của provider phát lại điều này và thất bại nếu nó không còn trả về hình dạng đó.

## CDC và integration test

| | Contract test | Integration test |
|---|---|---|
| Service đang chạy | Một lúc một cái | Tất cả cùng nhau |
| Tốc độ | Nhanh | Chậm |
| Bắt được | Phá vỡ hợp đồng | Vấn đề đấu nối thực tế |

## Tại sao điều này quan trọng

Contract test cho bạn sự tự tin rằng một thay đổi của provider sẽ không phá vỡ các consumer, mà không phải chịu chi phí và sự chập chờn của việc dựng cả hệ thống.

Chúng làm cho việc triển khai độc lập trở nên an toàn: pipeline của mỗi team biết ngay lập tức nếu thay đổi của nó sẽ vi phạm một hợp đồng mà ai đó phụ thuộc vào.

	Contract test	Integration test
Service đang chạy	Một lúc một cái	Tất cả cùng nhau
Tốc độ	Nhanh	Chậm
Bắt được	Phá vỡ hợp đồng	Vấn đề đấu nối thực tế