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

Modular Monolith

Một khối deploy với ranh giới module bên trong thật chặt: đơn giản và nhanh như monolith, nhưng được tổ chức để sau này tách module thành service — khi thật sự có nhu cầu.

Trung cấp 5 phút đọc· Cập nhật 2026-11-18

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

  • Giải thích điều gì làm monolith trở nên modular: ranh giới được ép buộc và dữ liệu có chủ.
  • So sánh lời gọi giữa các module trong process với lời gọi mạng giữa các service.
  • Thấy rủi ro chung số phận của một process và cách tách ra để cô lập.
  • Ép ranh giới module ngay trong code.

Nên đọc trước

Tổng quan

Một ngôi nhà nhiều phòng vẫn là một toà nhà: một mái, một cửa chính, đi giữa các phòng chỉ vài bước. Tường tốt giữ mùi bếp không lọt vào phòng ngủ. Nếu một ngày cần xây nhà phụ cho ông bà, một căn phòng được ngăn tách tốt sẽ dễ chuyển thành nhà phụ.

Modular monolith được deploy như một ứng dụng duy nhất, nhưng bên trong chia thành các module theo ranh giới nghiệp vụ (orders, customers, pricing). Mỗi module chỉ lộ ra một API công khai nhỏ, giấu phần bên trong và sở hữu các bảng của mình. Gọi giữa các module chỉ là gọi hàm — nhanh và tin cậy — còn ranh giới giữ cho code dễ thay đổi và giúp việc tách ra sau này khả thi.

Chạy thử

Một lượt thanh toán chạm tới năm module. So sánh A (trong process) với B (cùng các module nhưng thành service), rồi C và D, nơi phòng tài chính bắt đầu chạy report nặng lúc t = 10 s: ngay trong monolith (C) và khi đã tách thành service (D). Hãy nhìn trung vị (p50).

Đang tải mô phỏng…

Điều gì làm nó modular

  • Mỗi module một API công khai; mọi thứ khác đều là package-private.
  • Không dùng chung bảng: module đọc dữ liệu của module khác qua API (hoặc event) của nó, không bao giờ join thẳng vào bảng của nó.
  • Phụ thuộc chỉ đi một chiều và được kiểm tra bằng test, không phải bằng sự tự giác.
  • Event giữa các module cho các phản ứng ("đã đặt đơn → giữ hàng"), để các module không gọi nhau vòng tròn.

Ép ranh giới bằng Spring Modulith

Module là package cấp cao nhất; test sẽ lỗi khi có phụ thuộc trái phép
// com.shop.orders   — công khai: OrderService, OrderPlaced; nội bộ: orders.internal.*
// com.shop.inventory — lắng nghe OrderPlaced, không bao giờ import orders.internal

@ApplicationModuleListener               // chạy sau khi transaction của đơn hàng commit
void on(OrderPlaced event) {
    stock.reserve(event.orderId(), event.lines());
}

class ModularityTests {
    @Test
    void modulesRespectTheirBoundaries() {
        ApplicationModules.of(ShopApplication.class).verify();   // build lỗi khi có phụ thuộc bị cấm
    }
}

Đánh đổi

ĐượcMất
Đơn giảnMột lần build, một lần deploy, một transaction database khi cần.Mỗi thay đổi đều phải ship cả ứng dụng.
Hiệu năngGọi trong process: không độ trễ mạng, không lỗi cục bộ.Module dùng chung CPU, bộ nhớ và connection pool — một module nóng là tất cả chịu khổ.
Tiến hoáRanh giới rõ ràng làm việc tách sau này rẻ hơn.Ranh giới bị mài mòn nếu không có công cụ ép buộc.

Lưu ý khi chạy production

  • Cho việc nặng (report, export) thread pool riêng hoặc một bản deploy riêng của cùng codebase.
  • Giữ mỗi module một schema để sau này chuyển dữ liệu của nó đi chỉ là một lần migrate, không phải cuộc khảo cổ.
  • Theo dõi phụ thuộc giữa các module trong CI; vòng phụ thuộc lớn dần là dấu hiệu đầu tiên của một "big ball of mud".
  • Quan sát theo từng module (tag metric, trường log) để biết module nào cần tách nếu có nhu cầu.

Đọc thêm

Bài liên quan