Spring Boot Resilience4j

This adds Resilience4j fault tolerance patterns to Spring Boot 3.x services with circuit breakers, retries, rate limiters, bulkheads, and time limiters. You get annotation-based implementations for all the major patterns, plus fallback handling and exponential backoff for retries. The setup requires adding AOP and Actuator dependencies, then you can stack multiple patterns on the same method when you need layered protection. Configuration lives in application.yml with sensible defaults for sliding windows, failure thresholds, and wait durations. Honestly, the real value is in the fallback examples, which show you exactly how to degrade gracefully when services fail instead of just throwing exceptions up the stack.

skills.sh installs: 3.9K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-resilience4j --agent claude-code

Installs into .claude/skills of the current project.

Files

Spring Boot Resilience4j Patterns

Overview

Provides Resilience4j patterns (circuit breaker, retry, rate limiter, bulkhead, time limiter, fallback) for Spring Boot 3.x fault tolerance with configuration and testing workflows.

When to Use

Implementing fault tolerance and preventing cascading failures
Adding circuit breakers, retry logic, or rate limiting to service calls
Handling transient failures with exponential backoff
Protecting services from overload and resource exhaustion
Combining multiple patterns for comprehensive resilience

Instructions

1. Setup and Dependencies

Add Resilience4j dependencies to your project. For Maven, add to pom.xml:

<dependency>
    <groupId>io.github.resilience4j</groupId>
    <artifactId>resilience4j-spring-boot3</artifactId>
    <version>2.2.0</version> // Use latest stable version
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

For Gradle, add to build.gradle:

SKILL.md on GitHub