Đi tới nội dung chính
System Design Lab
Microservice Patterns

Backend for Frontend (BFF)

Mỗi trải nghiệm client — web, mobile, đối tác — có một backend mỏng riêng, gom và cắt gọn dữ liệu cho đúng màn hình đó, để client chỉ cần gọi một lần thay vì nhiều lần qua mạng chậm.

Cơ bản 5 phút đọc· Cập nhật 2026-11-18

Sau bài này bạn sẽ

  • Thấy vì sao số lượt đi về qua mạng di động mới là thứ quyết định độ trễ.
  • Thiết kế một BFF gom và cắt gọn dữ liệu cho một loại client.
  • Quyết định ai sở hữu BFF và BFF được chứa logic gì.
  • Triển khai việc gom dữ liệu song song với Spring WebFlux.

Nên đọc trước

Tổng quan

Nhà hàng có thực đơn ăn tại chỗ và thực đơn giao hàng. Cùng một bếp, nhưng thực đơn giao hàng bỏ những món dễ hỏng khi vận chuyển và gộp sẵn combo để bạn chỉ đặt một lần. BFF chính là thực đơn giao hàng cho một app cụ thể: cùng các service phía sau, nhưng đóng gói đúng thứ màn hình đó cần.

Backend for Frontend là một service nhỏ do đội làm client sở hữu (web, iOS/Android, API cho đối tác). Nó gọi các service nghiệp vụ, gom và cắt gọn dữ liệu, rồi chỉ mở ra đúng những endpoint client cần — mỗi màn hình một lời gọi thay vì mỗi service một lời gọi.

Vấn đề: một API cho mọi client

  • Client gọi quá nhiều: màn hình chính trên mobile cần dữ liệu users, orders và catalog — ba lượt đi về qua mạng có độ trễ 100–300 ms mỗi lượt.
  • Lấy thừa dữ liệu: endpoint dùng chung trả về mọi thứ mà client nào đó có thể cần; điện thoại phải tải và parse cả những field không bao giờ hiển thị.
  • Nhu cầu xung đột: web muốn dữ liệu đầy đủ, mobile muốn payload nhỏ, đối tác muốn ổn định — một đội API duy nhất thành điểm nghẽn.

Chạy thử

Hai kịch bản dùng cùng các service. Chỉ có số lượt đi về qua mạng di động chậm là khác. Tăng độ trễ mạng di động lên 250 ms và xem khoảng cách giãn ra.

Đang tải mô phỏng…

Triển khai với Spring WebFlux

MobileHomeController.java (BFF cho mobile)
@RestController
class MobileHomeController {

    private final WebClient users, orders, catalog;

    MobileHomeController(WebClient.Builder builder) {
        this.users = builder.baseUrl("http://users").build();
        this.orders = builder.baseUrl("http://orders").build();
        this.catalog = builder.baseUrl("http://catalog").build();
    }

    @GetMapping("/mobile/home")
    Mono<HomeScreen> home(@AuthenticationPrincipal Jwt jwt) {
        String userId = jwt.getSubject();
        Mono<UserCard> user = users.get().uri("/users/{id}/card", userId).retrieve().bodyToMono(UserCard.class);
        Mono<List<OrderSummary>> recent = orders.get().uri("/orders?customer={id}&limit=3", userId)
                .retrieve().bodyToFlux(OrderSummary.class).collectList()
                .timeout(Duration.ofMillis(300)).onErrorReturn(List.of());   // phần không bắt buộc
        Mono<List<ProductTile>> featured = catalog.get().uri("/featured?size=6").retrieve()
                .bodyToFlux(ProductTile.class).collectList();
        // Ba lời gọi chạy song song bên trong data centre.
        return Mono.zip(user, recent, featured).map(t -> new HomeScreen(t.getT1(), t.getT2(), t.getT3()));
    }
}

Nguyên tắc thực hành

  • Mỗi trải nghiệm người dùng một BFF, do chính đội làm client đó sở hữu.
  • Chỉ chứa logic trình bày: gom, cắt gọn, đổi tên, phân trang. Quy tắc nghiệp vụ thuộc về service nghiệp vụ.
  • Bảo vệ mỗi lời gọi phía sau bằng timeout và quyết định phần nào là không bắt buộc (fallback).
  • Các mối quan tâm chung ở biên (TLS, xác thực, rate limit) đặt ở một API Gateway phía trước các BFF.

Đánh đổi

ĐượcMất
Hiệu năngMỗi màn hình một lượt đi về và payload nhỏ.Thêm một chặng bên trong data centre.
Tự chủ của độiĐội client tự đổi API mà không phải chờ ai.Nhiều service hơn để deploy và vận hành; code lặp lại giữa các BFF.
Thiết kếAPI được định hình bởi màn hình thật.Logic nghiệp vụ dễ rò rỉ vào BFF nếu không ai để mắt.

Lưu ý khi chạy production

  • Đo độ trễ theo từng màn hình trên thiết bị thật, không chỉ thời gian xử lý ở server.
  • Đặt version cho endpoint của BFF mobile: các phiên bản app cũ còn được dùng hàng tháng trời.
  • GraphQL có thể thay thế nhiều endpoint BFF, nhưng các nguyên tắc về quyền sở hữu và logic vẫn giữ nguyên.

Đọc thêm

Bài liên quan