Sunday, March 3, 2024
HomeJavaThe right way to setup Request timeout in Spring Boot REST API?...

The right way to setup Request timeout in Spring Boot REST API? Instance Tutorial

Hiya guys, in case you are questioning the way to setup request timeout in your REST API utilizing Spring boot then you’ve gotten come to the best place. Very first thing first, while you make a request to a different API in manufacturing, you should add timeout as there is no such thing as a assure that you’ll obtain response in time. In the present day we’re going to try organising request timeout in Spring Boot Relaxation API. Earlier than making it into the subject. Let’s first perceive a number of phrases right here. What’s a Request timeout? A Request timeout is a deadline for companies to reply to requests. It ended up returning an error with standing 504 if the request fail to reply inside the specified time. Request timeouts can assist stop a nasty consumer expertise, particularly when a request is taking an extended to reply to. There are numerous methods to set request timeout in Spring Boot

Let’s undergo a number of of those approaches.

Timeout utilizing @Transactional annotation

To set request timeout on database queries or calls by utilizing Spring’s @Transactional annotation. We might set the timeout attribute that it has. It has a default worth of -1, which is identical as having no timeout in any respect.

To illustrate we’ve set this timeout to 50 seconds. An exception can be raised if the annotated technique takes longer than this period of time to execute. This method is sort of helpful for time-consuming database searches or long-running SQL queries.

Let’s see it in motion, we’ll create a easy relaxation endpoint that returns the scholar’s particulars as proven beneath.

@Desk(identify = "college students")
public class Pupil {
    @GeneratedValue(technique = GenerationType.AUTO)

    personal int id;
    personal int age;
    personal String identify;

    @OneToOne(cascade = CascadeType.ALL)
    @JoinColumn(identify = "department_id")
    personal Division division;


public interface StudentRepo extends JpaRepository<Pupil, Integer> {



@RequestMapping("/api/v1/college students")

public class StudentController {


    StudentRepo studentRepo;


    StudentRepoCustom studentRepoCustom;

    @RequestMapping(worth = "/", technique = RequestMethod.GET)

    @Transactional(timeout = 10)

    public ResponseEntity<Listing<Pupil>> getAllStudents(){

        return new ResponseEntity<>(studentRepoCustom.getStudents(), HttpStatus.OK);


    @RequestMapping(worth = "/{studentId}", technique = RequestMethod.GET)

    public ResponseEntity<?> getSingleStudent(@PathVariable int studentId){

        Non-compulsory<Pupil> s = studentRepo.findById(studentId);


            return new ResponseEntity<>(s, HttpStatus.OK);


            Map<String, Object> errorMessage = new HashMap<>();

            errorMessage.put("message", "Entity Not Discovered");

            errorMessage.put("standing", 404);

            return new ResponseEntity<>(errorMessage, HttpStatus.NOT_FOUND);






public class StudentService implements StudentRepoCustom {


    StudentRepo studentRepo;


    public Listing<Pupil> getStudents() {

        attempt {


        } catch (InterruptedException ie) {



        return studentRepo.findAll();



As you’ll be able to see, StudentService class has a technique getStudents() which returns all the scholar’s data from the Pupil entity. For demonstration functions, I’ve added an execution delay of 15 seconds(one might think about it a community delay). Which means the strategy will take at the very least 15 seconds earlier than it returns a response.

In StudentController, endpoint /college students are annotated with @Transactional with a customized timeout of 10 seconds. This implies the endpoint has to reply inside 10 seconds earlier than it throws an error. This endpoint is making a name to StudentService’s getStudents technique that has a delay of 15 seconds.

Word: It’s apparent, the endpoint /college students will return a 500 error message as a result of timeout restrict because it requires a response inside 10 seconds the place as the scholar service will take at the very least 15 seconds to reply.

How to setup Request timeout in Spring Boot REST API? Example Tutorial

Error Response

org.springframework.transaction.TransactionTimedOutException: Transaction timed out: deadline was Sat Mar 04 19:26:04 GMT 2023 


"timestamp": "2023-03-04T14:26:09.851+00:00",

"standing": 500,

"error": "Inside Server Error",

"path": "/api/v1/college students/"


Profitable Response

[ {

"id": 1,

"age": 26,

"name": "James Faulkner",

"department": {

"id": 1,

"name": "Chemistry",

"capacity": 110,

"specialization": "Micro Physics"


} ]

Utilizing WebClient timeout

Spring introduces the WebFlux framework, which helps reactive programming. To make HTTP requests we use the WebClient interface. It’s a reactive consumer that does not block when making HTTP requests. Its default underlying HTTP consumer library is Reactor Netty.

It permits us to set a timeout on a single exterior name quite than setting it on a complete endpoint. Though the vast majority of builders now use WebClient over RestTemplate, the older RestTemplate object from Spring should have timeouts configured.

Let’s see WebClient in motion with the assistance of an instance.

Add WebFlux dependency in your venture





The instance beneath reveals how a WebClient request to a reactive downstream endpoint would sometimes seem.




        .onStatus(HttpStatus::isError, clientResponse -> {

            LOGGER.error("Error whereas calling endpoint {} with standing code {}",

            uri.toString(), clientResponse.statusCode());

            throw new RuntimeException("Error whereas calling  accounts endpoint");




The time we wait after requesting a response is named the response timeout. The responseTimeout() operate could also be used to set it up for the consumer.

Let’s create a WebClient with a base URL that permits us to name oneself utilizing localhost and a response timeout of 10 seconds


public WebClient webClient() {

    return WebClient.builder()


            .clientConnector(new ReactorClientHttpConnector(





Now that, our WebClient has been injected into our controller, we are able to use it to entry our personal /college students endpoint, which nonetheless has a 15-sec timeout. As a result of we set the timeout for our WebClient to 10 seconds, it should crash significantly extra rapidly than 15 seconds.


public Pupil[] getWithWebClient() {

    return webClient.get()

            .uri(uriBuilder -> uriBuilder

                    .path("/college students/")






We are able to see that after contacting this endpoint, we do certainly receive a 500 HTTP error response indicating that the WebClient has timed out. The downstream @Transactional timeout may also be seen within the logs, but when we requested an exterior service quite than localhost, its timeout could be reported remotely.

With this technique, it’s attainable to configure totally different request timeouts for varied backend companies, which can be required. Additionally, there are different strategies for managing errors within the Mono or Flux response that publishers get from WebClient in response to a basic timeout subject.

Spring MVC timeout

There may be one other strategy to set a timeout in Spring Boot is by organising the spring mvc property as talked about beneath.


This enables us to outline request timeout in milliseconds precision. It’s to notice right here that, one can set this property externally, the property applies to the endpoints that return a Callable.

For demonstration, we’ve outlined an endpoint that additional calls the scholar’s service class and fetches the file.


public Callable<Listing<Pupil>> getWithMvcRequestTimeout() {

    return () -> {

        return studentRepoCustom.getStudents();



After we declare the applying property, Spring instantly implements the configuration. When the timeout is reached, the response is promptly returned, and an express 503 HTTP error is given instead of a extra basic 500 error. This timeout choice can be mechanically inherited by the entire endpoints in our app.


That is all in regards to the the way to setup the request timeout in Spring Boot REST APIs and HTTP requests. With this, we’ve reached the tip of our article. On this article, we’ve seen a number of methods to set request timeout in Spring Boot relaxation API. Among the many strategies, we’ve seen @Transactional timeout, Reactive programming WebClient, and Spring MVC.

One may want to make the most of Spring’s @Transactional technique and its timeout property to set a timeout on our database calls. 

The best strategy to create a world timeout for all requests is with the Spring MVC request-timeout property, nonetheless, WebClient additionally makes it easy to specify extra particular timeouts for every useful resource. We’re grateful on your helpful time. We hope this text has helped you perceive the subject.


Different Java and Spring articles it’s possible you’ll like

  • 10 Spring MVC annotations Java builders ought to study (annotations)
  • 5 Spring Boot Annotations for full-stack Java builders (tutorial)
  • Prime 5 Programs to study Microservices in Java? (programs)
  • Prime 5 Books and Programs to study RESTful Internet Service (books)
  • 10 Programs to study Spring Safety with OAuth 2 (programs)
  • 5 Programs to study Spring Cloud and Microservices (programs)
  • Java + Spring Boot + Microservice examination (venture)
  • 5 Spring Boot Options Each Java Developer Ought to Know (options)
  • 5 Course to Grasp Spring Boot on-line (programs)
  • 10 Issues Java Developer ought to study (objectives)
  • 10 Instruments Java Builders use of their day-to-day life (instruments)
  • 3 methods to alter Tomcat port in Spring Boot (tutorial)
  • 10 Tricks to turn out to be a greater Java developer (ideas)
  • 5 programs to study Spring Boot and Spring Cloud ( programs)
  • 10 Superior Spring Boot Programs for Java Programmers (programs)
  • 20 Spring Boot Interview Questions for Java Programmers (questions)
  • 3 Finest Practices Java Programmers can study from Spring (finest practices)

Thanks for studying this text thus far. When you discovered this Java +
Spring Boot + REST + HTTP Request timeout Tutorial helpful and useful then
please share them together with your colleagues and mates. You probably have any
questions or suggestions then please drop a observe. 

P. S. – In case you are eager to study REST API and Microservice however
new to this area and on the lookout for free on-line programs then you may also
checkout this listing of the 5 finest Microservice programs for learners. On this submit you will discover free Microservice programs from Udemy, Coursera, and YouTube. 


Please enter your comment!
Please enter your name here

Most Popular

Recent Comments