Spring Cloud là gì? Câu trả lời ngắn: nó không phải một framework mà bạn thêm vào để ứng dụng tự động thành microservices. Nó là một release train — tập hợp các module độc lập, được quản lý phiên bản cùng nhau, mỗi module giải quyết một vấn đề hạ tầng cụ thể. Hiểu sai điểm này là gốc của phần lớn kiến trúc “microservices” hỏng sau vài tháng.
Bản hiện tại là Spring Cloud 2025.1.4 (“Oakwood”), nhắm nhánh Spring Boot 4.0.x/4.1.x. Bản 2026.0.0-RC2 đang là preview, chưa GA — đừng đưa nó vào production chỉ vì số phiên bản trông mới hơn. Phần còn lại của bài nói về những gì Spring Cloud thật sự làm, module nào còn đáng dùng, và khi nào bạn nên bỏ qua nó.
Mục lục
Cập nhật 2026
- Release train mới, không phải framework mới. 2025.1.4 đóng gói Gateway 5.0.4, Config 5.0.6, Circuit Breaker 5.0.3, OpenFeign 5.0.4, Stream/Bus 5.0.4 — cùng một BOM, nhưng version từng module khác nhau.
- 2026.0.0-RC2 là preview. Nó đi cùng nhánh Boot kế tiếp và API còn có thể đổi. Chỉ thử trong nhánh thử nghiệm, không dùng cho hệ thống đang chạy khách hàng.
- Sleuth và Hystrix đã chết. Sleuth dừng ở line 3.1 và không hỗ trợ Boot 3+; Hystrix ngừng từ 2018. Thay thế hiện tại là Micrometer Tracing 1.7.2 và Resilience4j 2.4.0.
- Không còn
javax. Boot 4.1 dựa trên Jakarta EE 11; mọi importjavax.servlethayjavax.annotationtrong bài cũ phải đổi sangjakarta.
Release train: nhiều module, một phiên bản
Mỗi module Spring Cloud có repo, maintainer và nhịp release riêng. Release train tồn tại để chúng không lệch nhau: một BOM (spring-cloud-dependencies) ghim toàn bộ module vào một bộ version đã test với nhau. Bạn thêm spring-cloud-starter-gateway-server-webflux hay spring-cloud-starter-config mà không tự điền version; BOM quyết định.
Điều này có hai hệ quả thực tế. Thứ nhất, nâng một module thường kéo theo cả train — bạn không thể lấy Gateway 5.1.0-RC2 ghép với Config 5.0.6 rồi hy vọng mọi thứ khớp. Thứ hai, train gắn với một nhánh Boot: 2025.1.4 khai báo tương thích Boot 4.0.x và được dùng với Boot 4.1.x. Trang release ghi mức chính thức là Boot 4.0.9; chạy Boot 4.1.2 thì đọc release notes từng module trước.
BOM chỉ quản lý version module Cloud, không quản lý version Boot. Trộn train cũ với Boot mới vì thế vẫn tạo ra lỗi autoconfiguration khó debug; hãy ghim cả hai phía.
Các module còn thật sự quan trọng
Dưới đây là những module bạn sẽ gặp trong hệ thống thật.
Gateway — một cửa vào
Spring Cloud Gateway routing theo path, host hoặc header, thêm filter, xác thực biên, rate limit và biến đổi request. Nó không thay Spring Security trong service; chỉ là lớp biên. Hệ thống một ứng dụng thì Nginx hoặc Ingress là đủ.
Config — cấu hình tập trung
Config Server đọc cấu hình từ Git (hoặc Vault, JDBC) và phân phát theo spring.application.name + profile; client dùng spring.config.import=optional:configserver:http://localhost:8888. Giá trị thật là version history và một chỗ sửa cho nhiều service. Trên Kubernetes, ConfigMap và Secret đã làm được việc đó — thêm Config Server là thêm một service phải vá lỗi và giám sát.
Circuit Breaker — cô lập thất bại
Spring Cloud Circuit Breaker 5.0.3 là abstraction; implementation mặc định là Resilience4j 2.4.0. Nó bọc lời gọi qua mạng để lỗi của dịch vụ B không kéo sập A: timeout, giới hạn request đồng thời, ngắt mạch, fallback. Nhưng nó không cứu call treo vô hạn: vẫn phải đặt connect/read timeout ở tầng HTTP.
Gọi dịch vụ — @HttpExchange thay OpenFeign
Spring Cloud OpenFeign 5.0.4 vẫn nằm trong train nhưng đã feature-complete: chỉ nhận bugfix, và chính tài liệu của nó khuyến nghị chuyển sang Spring HTTP Service Clients. Với Boot 4.1, cách mặc định là interface @HttpExchange cộng HttpServiceProxyFactory; không cần annotation processor, không cần dependency ngoài Framework. OpenFeign vẫn chạy, nhưng đừng chọn nó cho code mới chỉ vì bài viết cũ dùng nó.
Discovery và LoadBalancer — không bắt buộc
Eureka vẫn được maintain trong Spring Cloud Netflix 5.0.3, nhưng không còn là mặc định. Trên Kubernetes, DNS của service đã là discovery; Consul hợp khi bạn có estate VM và service ngoài K8s. LoadBalancer (module trong Commons) cho phép dùng lb://service-name và chọn instance theo vòng tròn. Chỉ cần khi có nhiều instance và không muốn dùng load balancer hạ tầng.
Micrometer Tracing — người kế nhiệm Sleuth
Micrometer Tracing 1.7.2 không nằm trong release train; nó là dự án Micrometer mà Boot tích hợp sẵn. Nó tạo trace ID và span ID, lan chúng qua HTTP header, rồi xuất sang OTLP hoặc Zipkin. Đây là thứ thay Sleuth, không phải một module Cloud cùng họ — đừng đi tìm nó trong danh sách module của train.
Stream và Bus — còn đó, nhưng có điều kiện
Spring Cloud Stream 5.0.4 và Bus 5.0.4 vẫn được maintain. Stream cần broker (Kafka, RabbitMQ) và hợp khi bạn đã có hạ tầng messaging; Bus dùng broker để phát sự kiện refresh cấu hình. Đừng thêm chúng chỉ vì “microservices thì phải messaging” — một lời gọi HTTP có timeout và idempotency thường đơn giản hơn một topic.
Gateway: cấu hình tối thiểu
# File: src/main/resources/application.yml
spring:
cloud:
gateway:
server:
webflux:
routes:
- id: product-service
uri: lb://product-service
predicates:
- Path=/api/products/**
filters:
- StripPrefix=1
- id: order-service
uri: lb://order-service
predicates:
- Path=/api/orders/**
filters:
- StripPrefix=1
Ba điểm cần nhớ. Prefix hiện hành là spring.cloud.gateway.server.webflux.routes; config cũ dùng spring.cloud.gateway.routes phải sửa theo đường dẫn này. URI lb:// cần LoadBalancer trên classpath và một nguồn discovery, nếu không Gateway không biết product-service trỏ đi đâu. Và StripPrefix=1 bỏ đoạn /api trước khi chuyển tiếp.
Đặt xác thực ở Gateway là hợp lý, nhưng đừng đặt toàn bộ phân quyền nghiệp vụ ở đó: service vẫn phải kiểm tra quyền trên tài nguyên cụ thể, vì route có thể bị gọi qua đường khác.
Gọi service bằng @HttpExchange
// File: src/main/java/com/example/shop/catalog/ProductClient.java
package com.example.shop.catalog;
import java.util.List;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.service.annotation.GetExchange;
import org.springframework.web.service.annotation.HttpExchange;
@HttpExchange("/products")
public interface ProductClient {
@GetExchange
List<Product> findAll();
@GetExchange("/{id}")
Product findById(@PathVariable long id);
}
// File: src/main/java/com/example/shop/catalog/CatalogClientConfig.java
package com.example.shop.catalog;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestClient;
import org.springframework.web.client.support.RestClientAdapter;
import org.springframework.web.service.invoker.HttpServiceProxyFactory;
@Configuration
public class CatalogClientConfig {
@Bean
ProductClient productClient(RestClient.Builder builder) {
RestClient restClient = builder
.baseUrl("http://product-service:8080")
.build();
HttpServiceProxyFactory factory = HttpServiceProxyFactory
.builderFor(RestClientAdapter.create(restClient))
.build();
return factory.createClient(ProductClient.class);
}
}
Interface khai báo hợp đồng HTTP; proxy sinh implementation lúc runtime, không cần @EnableFeignClients. Base URL nên đến từ cấu hình, và RestClient cần connect timeout, read timeout rõ ràng — mặc định không đủ cho lời gọi liên service.
Khi có nhiều client, nhóm chúng bằng @ImportHttpServices(group = "catalog", types = ProductClient.class). Nếu cần gọi theo tên service đã đăng ký, dùng @LoadBalanced trên RestClient hoặc để Gateway routing; đừng tự chế discovery trong code nghiệp vụ.
Những sự thật khó nghe
Microservices không làm hệ thống đơn giản hơn; chúng chuyển độ phức tạp từ code sang hạ tầng và vận hành. Bốn cái giá thật:
- Mạng là thành phần có thể fail. Mỗi lời gọi có thể timeout sau khi service đích đã xử lý xong. Nếu thao tác không idempotent, retry sẽ tạo đơn hàng trùng hoặc trừ tiền hai lần.
- Latency cộng dồn. Một request đi qua năm service với p99 200ms mỗi chặng không còn 200ms; nó gần 1 giây, và đó là trong điều kiện bình thường.
- Không có transaction phân tán miễn phí.
@Transactionalchỉ có nghĩa trong một service và một database. Qua nhiều service, bạn cần saga, outbox, idempotency key, hoặc chấp nhận eventual consistency — đây là quyết định sản phẩm, không phải annotation. - Observability là bắt buộc. Không có trace ID xuyên service, log tập trung và metric theo service, việc debug một lỗi liên service là đoán mò. Chi phí này đến trước khi hệ thống lớn, không phải sau.
Ngoài ra là chi phí tổ chức: mỗi service một pipeline, một môi trường, một lịch vá bảo mật, một người trực. Số service phải tương ứng với số đội có thể sở hữu chúng, không phải số bảng trong database.
Modular monolith trước, microservices sau
Với phần lớn đội, bước đầu tiên đúng không phải tách service mà là làm rõ ranh giới trong một deployable duy nhất. Spring Modulith 2.1.2 làm việc này có kỷ luật: mỗi package là một module, module chỉ gọi API công khai của module khác, và test ApplicationModules.of(Application.class).verify() thất bại khi có vòng phụ thuộc hoặc truy cập xuyên ranh giới.
Bạn giữ được transaction đơn giản, một pipeline, một nơi debug — trong khi ranh giới đủ rõ để tách sau này. Khi một module thật sự cần scale hoặc deploy riêng, việc tách nhẹ hơn nhiều so với cắt một khối code chưa có ranh giới. Modulith cũng hỗ trợ event giữa các module, nên bạn thử được mô hình bất đồng bộ trước khi thêm broker.
Điều Modulith không làm: nó không tạo deploy độc lập và không đổi thực tế là mọi module vẫn chết cùng một process. Nó là công cụ để trì hoãn việc tách service cho đến khi có lý do thật.
Khi nào nên dùng Spring Cloud?
Dùng khi bạn có ít nhất một trong các điều kiện sau, và có người vận hành chúng:
- Nhiều đội cùng sở hữu hệ thống. Mỗi đội cần deploy mà không chờ đội khác; ranh giới service trùng với ranh giới tổ chức.
- Nhịp deploy độc lập là yêu cầu thật. Không phải “cho hiện đại”, mà vì một thay đổi nhỏ hiện phải qua regression của toàn bộ monolith.
- Nhu cầu scale đã được đo. Một module thật sự cần 20 instance trong khi phần còn lại cần 2; tách ra để scale độc lập có ý nghĩa kinh tế.
- Có năng lực platform. CI/CD, observability, on-call, quản lý secret và version đã có người chịu trách nhiệm.
Đừng dùng khi đội còn nhỏ, sản phẩm còn một deployable, hoặc chưa có ai trực hạ tầng. Trong những trường hợp đó, Spring Cloud không mua được gì ngoài thêm thứ phải bảo trì; modular monolith thường đi nhanh hơn và ít sự cố hơn.
| Nhu cầu | Lựa chọn Spring Cloud | Thay thế đơn giản hơn |
|---|---|---|
| Một cửa vào, routing | Gateway | Nginx, Ingress của Kubernetes |
| Cấu hình tập trung | Config Server | ConfigMap/Secret, biến môi trường |
| Gọi service khác | @HttpExchange + proxy |
Gọi module trong cùng process |
| Cô lập lỗi | Circuit Breaker + Resilience4j | Timeout, retry có giới hạn, bulkhead |
| Discovery | Eureka, Consul, K8s client | DNS, danh sách URL tĩnh |
| Cân bằng tải client-side | Spring Cloud LoadBalancer | Load balancer của hạ tầng |
| Tracing xuyên service | Micrometer Tracing | Actuator + OTel, log correlation ID |
| Messaging bất đồng bộ | Stream, Bus | Client Kafka/RabbitMQ trực tiếp |
Sáu cái bẫy hay gặp
- Distributed monolith. Nhiều service nhưng luôn deploy cùng nhau, dùng chung model, gọi đồng bộ theo chuỗi. Bạn trả giá microservices mà không nhận lợi ích nào. Dấu hiệu: mọi release cần tất cả service lên cùng lúc.
- Database dùng chung. Hai service cùng ghi một bảng thì ranh giới chỉ là hình thức; schema đổi ở service này làm vỡ service kia. Mỗi service phải sở hữu dữ liệu của mình, trao đổi qua API hoặc event.
- Chuỗi gọi đồng bộ. A gọi B, B gọi C, C gọi D; độ trễ và xác suất lỗi nhân lên, và mỗi chặng thiếu timeout thì cả chuỗi treo. Giới hạn độ sâu, thêm timeout, hoặc chuyển phần không cần kết quả ngay sang event.
- Lệch version train và Boot. Cloud 2025.1.4 với Boot 4.2 RC, hoặc tự nâng riêng một module. Ghim cả hai phía và đọc ma trận compatibility trước khi nâng.
- Coi Eureka là bắt buộc. Trên Kubernetes, DNS đã giải quyết discovery; thêm Eureka là thêm một cluster phải vận hành và một điểm tin cậy mới. Chỉ dùng khi môi trường thật sự cần registry tập trung ngoài K8s.
- Config Server khi ConfigMap đủ dùng. Nếu cấu hình ít thay đổi và đã nằm trong manifest, Config Server chỉ thêm độ trễ khởi động và một thành phần có thể sập. Dùng nó khi bạn cần refresh động, nhiều môi trường, hoặc version history trên Git.
Bẫy thứ bảy, ít được nói: dùng OpenFeign cho code mới. Nó vẫn chạy nhưng feature-complete; chọn @HttpExchange từ đầu rẻ hơn migrate sau.
Nhìn về 2027
Spring Cloud 2026.0 vẫn ở RC; khi GA, nó đi kèm một nhánh Boot mới và có thể đổi Gateway. Xu hướng rõ hơn là dịch chuyển về hạ tầng: Kubernetes lo discovery và config, tracing theo OTLP, Spring Cloud thu hẹp về Gateway, Circuit Breaker và HTTP client. OpenFeign tiếp tục teo lại; @HttpExchange là mặc định.
Checklist
- Ghim
spring-cloud-dependencies2025.1.4 và Boot 4.1.2; không trộn RC vào production. - Chỉ thêm module bạn có lý do cụ thể — Gateway, Config, Circuit Breaker, client — không thêm cả train.
- Mọi lời gọi liên service có connect/read timeout, retry có giới hạn và idempotency key.
- Bật Micrometer Tracing và log trace ID trước khi tách service đầu tiên, không phải sau.
- Thử Spring Modulith 2.1.2 trong monolith hiện tại để kiểm tra ranh giới trước khi quyết định tách.
- Không dùng chung database giữa các service; không dùng Eureka nếu Kubernetes DNS đã đủ.
Đi tiếp trong series: Spring Cloud Gateway, Spring Cloud Config, và Circuit Breaker trong Spring Cloud. Bức tranh tổng thể nằm ở Spring Boot Roadmap.



