Advanced QA & Test Engineering
Trang chủ / Module 3
🤝 Module 3 / 15 · 1 tuần

Contract Testing giữa Microservices

Đảm bảo tương thích API giữa các service độc lập mà không cần dựng toàn bộ hệ thống để test tích hợp — kỹ thuật ít QA biết nhưng cực kỳ mạnh.

PactConsumer-Driven
📌 Vì sao module này quan trọng

Đây là "chiêu thức thất truyền" — rất nhiều QA có kinh nghiệm nhiều năm chưa từng nghe đến Contract Testing, dù nó giải quyết đúng vấn đề đau đầu nhất của kiến trúc microservices (đã học ở khoá System Architecture): làm sao biết Service A và Service B vẫn "hiểu nhau" mà không phải dựng cả 2 lên để test tích hợp đầy đủ mỗi lần.

🎯 Mục tiêu học tập

  • Hiểu vấn đề Contract Testing giải quyết mà Integration Testing truyền thống không làm được
  • Áp dụng mô hình Consumer-Driven Contract với Pact
  • Tích hợp Contract Testing vào pipeline CI/CD qua Pact Broker
  • Nhận diện đúng ranh giới: khi nào cần Contract Testing, khi nào Integration Test truyền thống là đủ

Vấn đề Contract Testing Giải quyết

Với kiến trúc microservices (đã học ở khoá System Architecture, Module 3), Service A (Consumer) gọi API của Service B (Provider). Cách kiểm tra tương thích truyền thống — Integration Test đầy đủ (dựng cả A và B thật, test luồng end-to-end) — chậm, phức tạp, và không scale khi có hàng chục service: muốn test Service A cần dựng B, C, D... mọi service nó phụ thuộc.

Contract Testing giải quyết bằng cách không cần dựng cả 2 service cùng lúc: Consumer viết ra kỳ vọng của mình về API (contract) dưới dạng test chạy độc lập với mock, contract này được lưu lại; Provider sau đó verify chính contract đó (không phải giả lập gì, mà chạy contract thật lên code thật của Provider) trong pipeline CI của riêng mình — nếu Provider đổi API theo cách phá vỡ kỳ vọng của Consumer, verify sẽ fail ngay trong CI của Provider, trước khi deploy gây lỗi thật.

Consumer-Driven Contract với Pact

# Phía Consumer (Service A) — định nghĩa kỳ vọng về API của Provider
def test_get_user_contract(pact):
    expected = {"id": 123, "name": "Nguyen Van A", "email": Matcher.like("a@example.com")}

    (pact
     .given("user 123 exists")
     .upon_receiving("a request for user 123")
     .with_request("GET", "/users/123")
     .will_respond_with(200, body=expected))

    with pact:
        response = user_service_client.get_user(123)
        assert response["name"] == "Nguyen Van A"
    # Pact tự động sinh ra 1 file contract (JSON) mô tả chính xác kỳ vọng này
# Phía Provider (Service B) — verify lại đúng contract mà Consumer đã định nghĩa
def test_verify_pact_with_service_a():
    verifier = Verifier(provider="UserService", provider_base_url="http://localhost:8080")
    verifier.verify_with_broker(
        broker_url="https://pact-broker.example.com",
        publish_verification_results=True,
    )
    # Provider chạy contract thật lên code thật của mình — không phải giả lập

Tên gọi "Consumer-Driven" phản ánh đúng bản chất: Consumer là bên định nghĩa kỳ vọng (không phải Provider tự quyết định API "nên" như thế nào rồi Consumer phải thích nghi) — phù hợp thực tế vì Consumer mới biết chính xác họ cần gì từ API, Provider chỉ cần đảm bảo không phá vỡ những gì đã cam kết.

Pact Broker & Tích hợp CI/CD

Pact Broker là kho lưu trữ trung tâm cho mọi contract giữa các service — khi Consumer publish 1 contract mới, Broker biết chính xác Provider nào cần verify lại; khi Provider verify xong, kết quả được publish ngược lại Broker. Tính năng mạnh nhất: can-i-deploy — trước khi deploy Service A lên production, hỏi Broker "phiên bản này có tương thích với mọi Provider nó phụ thuộc trong môi trường production không?" — nếu bất kỳ contract nào chưa được verify thành công, chặn deploy ngay, đúng tinh thần "test là cổng chặn deploy" đã học xuyên suốt các khoá trước.

pact-broker can-i-deploy --pacticipant ServiceA --version 1.4.2 --to-environment production

Ranh giới: Khi nào cần Contract Testing

Tình huốngLựa chọn phù hợp
Monolith/Modular Monolith (đã học ở khoá Architecture, Module 3)Không cần — không có ranh giới network giữa các module để "vỡ hợp đồng"
Vài microservices, thay đổi API hiếm khi xảy raIntegration Test truyền thống có thể đã đủ, chi phí thiết lập Contract Testing chưa xứng đáng
Nhiều team độc lập, nhiều microservices, API thay đổi thường xuyênContract Testing mang lại giá trị rất lớn — chính xác là bài toán nó sinh ra để giải quyết

🏋️ Bài tập thực hành

Thiết lập Contract Testing giữa 2 Service

Với 2 service đơn giản (ví dụ Order Service gọi đến User Service), viết contract test phía Consumer bằng Pact, verify contract đó phía Provider. Cố tình đổi API Provider theo cách phá vỡ kỳ vọng (ví dụ đổi tên field), chạy lại verify và xác nhận nó fail đúng như dự kiến — đây chính là giá trị cốt lõi của kỹ thuật này: phát hiện breaking change trước khi deploy.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Giải thích được vấn đề Contract Testing giải quyết mà Integration Test không làm được
  • Viết được contract test phía Consumer và verify phía Provider bằng Pact
  • Hiểu vai trò của Pact Broker và tính năng can-i-deploy
  • Nhận diện đúng khi nào cần Contract Testing, khi nào không cần thiết