Hystrix đã chết, nhưng các mẫu thiết kế nó phổ biến thì vẫn sống. Đó là lý do bài cũ vẫn được đọc, và cũng là lý do nó nguy hiểm: làm theo hướng dẫn cũ, bạn thêm một dependency không tồn tại cho Boot 3/4 rồi mất buổi chiều sửa build. Giữ nguyên search intent, bài này làm hai việc: giải thích Hystrix thực sự làm gì, rồi chuyển từng khái niệm sang thứ đang chạy được — Resilience4j trên Spring Cloud Circuit Breaker 5.0.3 và Spring Boot 4.1.2.
Mục tiêu không phải là “dùng đúng thư viện”, mà là một lời gọi ra ngoài không treo thread vô hạn, không kéo sập ứng dụng, và luôn có câu trả lời có nghĩa khi dịch vụ đích hỏng.
Mục lục
Cập nhật 2026
- Hystrix dừng ở 1.5.18 (2018), và starter
spring-cloud-starter-netflix-hystrixdừng ở2.2.10.RELEASE— dòng Spring Boot 2.3. Không có bản nào cho Boot 3 hay Boot 4, nên dependency đơn giản là không resolve. - Cả bộ công cụ đã chết cùng lúc:
@EnableCircuitBreaker,@HystrixCommand, endpoint/hystrix.stream, Hystrix Dashboard và Turbine đều không còn được bảo trì. Metric giờ đi qua Actuator + Micrometer. - Resilience4j 2.4.0 là bản mới nhất của thư viện. Spring Cloud Circuit Breaker 5.0.3 quản lý sẵn 2.3.0; muốn 2.4.0 thì import
resilience4j-bomvà khai báo các module bạn thực dùng. - Framework 7 có retry trong lõi (
@Retryable,@EnableResilientMethods). Với nhu cầu chỉ là thử lại vài lần, bạn không cần Circuit Breaker.
Hystrix đã làm gì cho hệ phân tán
Hystrix ra đời trong bối cảnh mỗi service chạy trên thread pool Tomcat hữu hạn và gọi nhau bằng HTTP đồng bộ. Ba triệu chứng nó nhắm tới: dependency phản hồi chậm làm cạn thread, dependency lỗi liên tục làm lãng phí mọi lời gọi, và lỗi lan từ service này sang service khác cho tới khi cả hệ thống ngừng thở. Cách nó giải quyết là đóng gói lời gọi, cô lập tài nguyên, và ngắt mạch khi tỷ lệ lỗi vượt ngưỡng.
Command là đơn vị cơ bản
Mọi tương tác ra ngoài được bọc trong HystrixCommand (hoặc HystrixObservableCommand cho luồng RxJava). Command không chỉ là lớp trang trí: nó là đơn vị để áp timeout, breaker, fallback, bulkhead và metric. Mọi thứ Hystrix làm đều gắn với một command có tên và một key.
Cô lập bằng thread pool
Mặc định Hystrix chạy mỗi command trên một thread pool riêng, gom theo groupKey, với coreSize, maxQueueSize, queueSizeRejectionThreshold. Đó là bulkhead theo nghĩa đen: 10 thread cho catalog, 10 cho payment; pool của catalog cạn thì lời gọi bị từ chối ngay thay vì chiếm thread Tomcat. Chế độ SEMAPHORE nhẹ hơn nhưng chạy trên thread gọi, nên không cắt được lời gọi đang treo.
Timeout, fallback, breaker
Timeout mặc định 1000 ms; quá hạn thì command bị ngắt và fallback được gọi. Fallback là một method cùng chữ ký, có thể nhận thêm Throwable ở cuối, và phải trả về giá trị chứ không được ném lỗi. Breaker có ba trạng thái: CLOSED ghi lỗi trong cửa sổ trượt; đủ requestVolumeThreshold lời gọi và tỷ lệ lỗi vượt errorThresholdPercentage thì sang OPEN và chặn mọi lời gọi; sau sleepWindowInMilliseconds sang HALF_OPEN, thử vài lời gọi, thành công thì đóng, thất bại thì mở tiếp.
Request collapsing và caching
Hai tính năng ít người dùng nhưng đáng nhớ. Request collapsing gộp nhiều lời gọi cùng tham số trong một cửa sổ ngắn thành một lời gọi batch. Request caching trả lại kết quả trong cùng một ngữ cảnh request. Cả hai dựa vào thread-local của Hystrix, nên không sống sót qua một ranh giới async — đây chính là dấu hiệu kiến trúc đã lỗi thời.
Metric và dashboard
Mỗi command phát ra một luồng số liệu JSON qua /hystrix.stream: số lời gọi, tỷ lệ lỗi, trạng thái mạch, phân bố latency. Hystrix Dashboard đọc luồng đó và vẽ biểu đồ; Turbine gộp nhiều instance. Mô hình này cần một ứng dụng Java riêng chỉ để xem metric, và không ai còn vận hành nó.
Vì sao Hystrix chết
Không phải vì nó dở. Nó chết vì chi phí vận hành và vì kiến trúc Spring đã đổi.
- Bảo trì: bản cuối là 1.5.18 từ 2018, không có bản vá cho JDK mới. Chạy nó trên JDK 25 là tự nhận rủi ro về reflection và thư viện bytecode.
- Thread pool cho từng command: mỗi command mặc định 10 thread. Năm mươi lời gọi khác nhau là 500 thread chỉ để chờ, cộng chi phí chuyển ngữ cảnh. Với virtual thread từ Java 21, mô hình “cấp thread riêng để cô lập” mất phần lớn lý do tồn tại.
- Không có mô hình reactive: Hystrix dựa trên RxJava 1, trong khi WebFlux chạy trên Reactor — và không có bản Reactor.
- Không theo kịp Jakarta và Boot 3/4: starter dừng ở Boot 2.3, và Hystrix bị gỡ khỏi release train Spring Cloud Netflix từ 2020.
- Resilience4j làm đúng phần cốt lõi: mỗi mẫu là một module riêng, trang trí hàm thuần, không cần thread pool riêng, chạy được cả sync lẫn reactive.
Quy đổi khái niệm 1:1
| Hystrix | Resilience4j / Spring Cloud 2026 | Ghi chú |
|---|---|---|
@HystrixCommand(fallbackMethod = "x") |
CircuitBreakerFactory.create(id).run(supplier, fallback) hoặc @CircuitBreaker(name, fallbackMethod) |
Ở dạng factory, fallback là một Function, không phải tên method |
execution.isolation.thread.timeoutInMilliseconds |
resilience4j.timelimiter.instances.<id>.timeoutDuration |
Factory bật TimeLimiter mặc định |
threadPoolProperties.coreSize + groupKey |
resilience4j.thread-pool-bulkhead.instances.<id> hoặc resilience4j.bulkhead.instances.<id> |
Thread-pool bulkhead chỉ áp dụng cho method trả về CompletionStage |
circuitBreaker.requestVolumeThreshold |
minimumNumberOfCalls |
Cùng ý nghĩa: đủ mẫu mới tính tỷ lệ |
circuitBreaker.errorThresholdPercentage |
failureRateThreshold |
Phần trăm, mặc định 50 |
circuitBreaker.sleepWindowInMilliseconds |
waitDurationInOpenState |
Thời gian giữ OPEN |
metrics.rollingStats.timeInMilliseconds + numBuckets |
slidingWindowType + slidingWindowSize |
TIME_BASED thay cho cửa sổ theo ms |
/hystrix.stream, Dashboard, Turbine |
Actuator + resilience4j-micrometer → Prometheus/OTel |
Không cần ứng dụng giám sát riêng |
| Request collapsing, request caching | Không có tương đương | Gộp ở tầng API hoặc dùng endpoint batch |
Trước và sau: cùng một lời gọi
Đây là code cũ, giữ lại để bạn nhận ra nó trong dự án đang bảo trì: chỉ build với Spring Cloud Netflix 2.2.x và Boot 2.3, và dùng RestTemplate — thứ đã bị deprecate trong Framework 7.
// File: src/main/java/vn/evotek/catalog/ProductClient.java
// Legacy: @HystrixCommand của Spring Cloud Netflix 2.2.x
@Service
public class ProductClient {
private final RestTemplate restTemplate;
public ProductClient(RestTemplate restTemplate) {
this.restTemplate = restTemplate;
}
@HystrixCommand(
fallbackMethod = "fallback",
commandProperties = {
@HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "2000"),
@HystrixProperty(name = "circuitBreaker.requestVolumeThreshold", value = "20"),
@HystrixProperty(name = "circuitBreaker.errorThresholdPercentage", value = "50"),
@HystrixProperty(name = "circuitBreaker.sleepWindowInMilliseconds", value = "30000")
},
threadPoolProperties = {
@HystrixProperty(name = "coreSize", value = "10")
})
public String product(String id) {
return restTemplate.getForObject("http://catalog/products/" + id, String.class);
}
String fallback(String id, Throwable error) {
return "{\"id\":\"" + id + "\",\"status\":\"unavailable\"}";
}
}
Bản 2026 dùng CircuitBreakerFactory của Spring Cloud Circuit Breaker, gọi bằng RestClient. Không annotation, không AOP, không thread pool riêng: breaker và time limiter lấy cấu hình theo id productService, fallback là một hàm thuần.
// File: src/main/java/vn/evotek/catalog/ProductClient.java
@Service
public class ProductClient {
private final RestClient restClient;
private final CircuitBreakerFactory<?, ?> breakers;
public ProductClient(RestClient.Builder builder, CircuitBreakerFactory<?, ?> breakers) {
this.restClient = builder.baseUrl("https://catalog.internal").build();
this.breakers = breakers;
}
public Product product(String id) {
return breakers.create("productService")
.run(
() -> restClient.get()
.uri("/products/{id}", id)
.retrieve()
.body(Product.class),
error -> Product.unavailable(id));
}
}
Nếu team bạn thích annotation hơn, dùng @CircuitBreaker từ resilience4j-spring-boot4; tên breaker phải khớp key trong cấu hình, và method fallback vẫn phải cùng chữ ký, có thể nhận thêm Throwable. Đừng trộn hai cách trong một class: khó biết cấu hình nào đang thắng.
// File: src/main/java/vn/evotek/catalog/ProductClient.java
@CircuitBreaker(name = "productService", fallbackMethod = "fallback")
public Product product(String id) {
return restClient.get().uri("/products/{id}", id).retrieve().body(Product.class);
}
private Product fallback(String id, Throwable error) {
return Product.unavailable(id);
}
Cấu hình YAML
Factory đọc cấu hình theo id breaker, nên phần lớn việc chỉnh hành vi nằm ở đây chứ không nằm trong code. Bốn khối dưới đây là bộ tối thiểu cho một dependency HTTP.
resilience4j:
circuitbreaker:
instances:
productService:
slidingWindowType: COUNT_BASED
slidingWindowSize: 20
minimumNumberOfCalls: 10
failureRateThreshold: 50
slowCallDurationThreshold: 1s
slowCallRateThreshold: 80
waitDurationInOpenState: 30s
permittedNumberOfCallsInHalfOpenState: 3
registerHealthIndicator: true
timelimiter:
instances:
productService:
timeoutDuration: 2s
cancelRunningFuture: true
bulkhead:
instances:
productService:
maxConcurrentCalls: 16
maxWaitDuration: 0
retry:
instances:
productService:
maxAttempts: 2
waitDuration: 300ms
enableExponentialBackoff: true
exponentialBackoffMultiplier: 2
retryExceptions:
- java.net.ConnectException
ignoreExceptions:
- io.github.resilience4j.circuitbreaker.CallNotPermittedException
Hai điểm dễ hiểu sai. spring-cloud-starter-circuitbreaker-resilience4j chỉ đóng gói breaker và time limiter vào factory; bulkhead và retry đến từ module Resilience4j và chỉ chạy khi được áp qua decorator hoặc annotation. Và maxWaitDuration: 0 nghĩa là từ chối ngay khi đủ 16 lời gọi đồng thời — fail-fast, không phải xếp hàng.
Checklist migration
- Kiểm kê trước khi sửa. Grep
@HystrixCommand,@HystrixProperty,@EnableCircuitBreaker,@EnableHystrix,HystrixCommandGroupKey,hystrix.stream,turbine. Đó là phạm vi thật của migration. - Đổi dependency. Bỏ
spring-cloud-starter-netflix-hystrix, thêmspring-cloud-starter-circuitbreaker-resilience4j; import BOM Spring Cloud 2025.1.4 và, nếu cần,resilience4j-bom2.4.0. - Xóa annotation bật/tắt.
@EnableCircuitBreakervà@EnableHystrixkhông còn; Spring Boot tự cấu hình factory khi starter có trên classpath. - Đổi từng lời gọi. Annotation thành
run(supplier, fallback)hoặc@CircuitBreaker; fallback method thànhFunction; bỏ mọi property dạng chuỗi. - Đặt timeout hai lớp. TimeLimiter cho ngân sách tổng, read timeout trên
RestClient/WebClientcho tầng socket. Một lớp là không đủ. - Cấu hình theo lưu lượng thật. Cửa sổ 20 và tối thiểu 10 chỉ đúng với endpoint vài chục request/phút. Đo trước, rồi chọn.
- Viết lại test. Test ba nhánh: thành công, lỗi có fallback, và mạch mở (mock registry hoặc cho breaker mở thật). Test cũ dựa trên
HystrixCommandkhông còn biên dịch. - Chuyển metric. Bật Actuator, thêm
resilience4j-micrometer, xóa cấu hình dashboard/Turbine, thêm alert chonot_permitted.
Bốn mẫu phải làm đúng
Timeout là ngân sách, không phải tuỳ chọn
Đặt timeout theo SLO của endpoint, không theo cảm giác: lời gọi 2 giây trong request cần 300 ms là vô nghĩa. TimeLimiter không giết được thread đang block — nó trả TimeoutException cho bên gọi, còn lời gọi gốc chạy tới khi socket timeout. Vì vậy read timeout ở client là bắt buộc.
Retry chỉ cho lời gọi idempotent
GET, DELETE và PUT có idempotency key thì retry được; POST tạo đơn hàng thì không, trừ khi có key chống trùng. Giới hạn 2–3 lần, có backoff và jitter, không retry 4xx (429 là ngoại lệ có chủ đích). Retry bọc ngoài breaker phải ignore CallNotPermittedException, nếu không bạn đập vào mạch đang mở.
Fallback phải là hàm cục bộ
Fallback tốt trả về dữ liệu mặc định, cache có đánh dấu cũ, hoặc lỗi có kiểu rõ ràng. Fallback gọi mạng là biến nó thành dependency mới; fallback ném lỗi là che mất lỗi gốc. Đừng nuốt 404 vào cùng nhánh “unavailable” — 404 là dữ liệu không tồn tại, 503 là hệ thống không trả lời.
Fail-fast phải nhìn thấy được
Khi mạch mở, CallNotPermittedException là tín hiệu đúng: map thành 503 kèm Retry-After thay vì 200 với danh sách rỗng. Người dùng thấy “tạm thời không có dữ liệu” còn hơn một trang trắng trông như thành công.
Bốn cái bẫy khi copy bài cũ
- Dependency không tồn tại.
spring-cloud-starter-netflix-hystrixkhông có bản Boot 3/4. Build fail ngay ở bước resolve, và mọi hướng dẫn thêm@EnableCircuitBreakerđều dẫn tới cùng một ngõ cụt. - Bọc lời gọi cục bộ. Breaker quanh một truy vấn DB trong cùng process hay một phép tính sẽ mở vì lỗi nghiệp vụ và không bảo vệ được gì. Chỉ bọc lời gọi qua ranh giới process.
@TimeLimitertrên method đồng bộ. Annotation này chỉ có tác dụng với method trả vềCompletionStage. Đặt lên method thường thì không có lỗi, cũng không có timeout — kiểu sai nguy hiểm nhất.- Bulkhead thread pool cho code sync.
thread-pool-bulkheadcần lời gọi async; với code blocking, dùngbulkheadsemaphore hoặc giới hạn connection pool của client.
Chọn gì cho trường hợp nào
| Nhu cầu | Dùng | Đừng dùng |
|---|---|---|
| Chỉ cần thử lại vài lần trong process | @Retryable + @EnableResilientMethods của Framework 7 |
Cả một breaker cho một lời gọi nội bộ |
| Cần breaker, timeout, bulkhead, metric cùng lúc | Resilience4j qua Spring Cloud Circuit Breaker | Retry của Framework 7 trộn với breaker tự viết |
| Luồng WebFlux | Reactive factory hoặc decorator Reactor của Resilience4j | Blocking call trong luồng reactive |
| Hệ thống cũ còn Hystrix | Giữ nguyên, chỉ sửa khi có việc; lên kế hoạch migration | Nâng Boot 3/4 mà vẫn giữ Hystrix |
2027: điều gì đang thay đổi
Retry trong lõi Framework 7 sẽ tiếp tục hút các trường hợp đơn giản, nên breaker dần chỉ còn dành cho lời gọi qua mạng. Spring Cloud 2026.0.0 đang ở RC2 và đi cùng dòng Boot 4.2; Resilience4j vẫn ở nhánh 2.x, chưa có thông báo về bản 3.0. Làm migration dependency trước khi nâng Boot — nó rẻ hơn migration kiến trúc.
Checklist trước khi merge
- Không còn
@HystrixCommand,@EnableCircuitBreaker,hystrix.streamhay Turbine trong code và cấu hình. - Mỗi lời gọi ra ngoài có timeout ở tầng client và ngân sách ở tầng breaker.
- Retry chỉ đặt trên lời gọi idempotent, có giới hạn lần và ignore
CallNotPermittedException. - Fallback thuần cục bộ, không gọi mạng, phân biệt 404 với 503.
- Metric chảy ra Prometheus hoặc OTel, có alert cho
not_permittedvàstate=open. - Test đã chạy qua ba nhánh: thành công, lỗi có fallback, mạch mở.
Đọc tiếp trong series: cơ chế circuit breaker trong Spring Cloud, gọi dịch vụ với OpenFeign để đặt fallback đúng chỗ, và Spring Cloud là gì nếu bạn cần nắm release train trước khi chọn version. Toàn bộ thứ tự bài nằm ở Spring Boot Roadmap.



