Tareas en paralelo en Spring Boot con @Async e hilos virtuales

Cómo cotizar con tres paqueterías a la vez en lugar de una tras otra con @Async y CompletableFuture, aprovechando los hilos virtuales de Java 25, y medir la diferencia.

El problema: esperar en fila

Para mostrar el envío más barato hay que preguntarle a tres paqueterías, y cada una tarda un segundo. Si se pregunta una tras otra, el cliente espera tres segundos. Pero las tres preguntas son independientes: se pueden hacer al mismo tiempo y esperar solo lo que tarde la más lenta. Para eso sirve @Async: el método se ejecuta en otro hilo y quien lo llama recibe al instante una promesa del resultado, un CompletableFuture.

Activarlo

package com.ejemplo.asincrono;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableAsync;

@SpringBootApplication
@EnableAsync
public class AsincronoApplication {

    public static void main(String[] args) {
        SpringApplication.run(AsincronoApplication.class, args);
    }

}
spring.application.name=asincrono
spring.threads.virtual.enabled=true

spring.threads.virtual.enabled=true le pide a Spring Boot usar hilos virtuales de Java 21 y posteriores, tanto para las peticiones web como para las tareas con @Async. Un hilo virtual cuesta muy poco, así que esperar un segundo a una paquetería no ocupa un hilo del sistema operativo; puedes tener miles esperando a la vez.

El servicio y el controlador

package com.ejemplo.asincrono;

import java.math.BigDecimal;
import java.util.concurrent.CompletableFuture;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;

@Service
public class Paqueterias {

    private static final Logger log = LoggerFactory.getLogger(Paqueterias.class);

    public record Cotizacion(String paqueteria, BigDecimal costo) {
    }

    @Async
    public CompletableFuture<Cotizacion> cotizar(String paqueteria, BigDecimal costo) throws InterruptedException {
        log.info("Cotizando con {} en el hilo {}", paqueteria, Thread.currentThread());
        Thread.sleep(1000);                         // cada paquetería tarda un segundo en responder
        return CompletableFuture.completedFuture(new Cotizacion(paqueteria, costo));
    }
}
package com.ejemplo.asincrono;

import java.math.BigDecimal;
import java.util.Comparator;
import java.util.List;
import java.util.concurrent.CompletableFuture;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EnvioController {

    private final Paqueterias paqueterias;

    public EnvioController(Paqueterias paqueterias) {
        this.paqueterias = paqueterias;
    }

    @GetMapping("/envio/mas-barato")
    public Paqueterias.Cotizacion masBarato() throws InterruptedException {
        List<CompletableFuture<Paqueterias.Cotizacion>> pendientes = List.of(
                paqueterias.cotizar("Paquetería Norte", new BigDecimal("189.00")),
                paqueterias.cotizar("Envíos del Bajío", new BigDecimal("149.50")),
                paqueterias.cotizar("Rápido Sur", new BigDecimal("212.00")));
        CompletableFuture.allOf(pendientes.toArray(CompletableFuture[]::new)).join();
        return pendientes.stream().map(CompletableFuture::join)
                .min(Comparator.comparing(Paqueterias.Cotizacion::costo)).orElseThrow();
    }
}

El controlador llama tres veces a cotizar; cada llamada regresa de inmediato con su CompletableFuture. allOf(...).join() espera a que terminen las tres, y después se elige la más barata.

Probarlo

terminal$ curl -s -w "  (%{time_total} s)\n" localhost:8080/envio/mas-barato
{"paqueteria":"Envíos del Bajío","costo":149.50}  (1.115759 s)
registro de la aplicación2026-11-22T10:36:20.040-06:00  INFO 95 --- [asincrono] [         task-1] com.ejemplo.asincrono.Paqueterias        : Cotizando con Paquetería Norte en el hilo VirtualThread[#64,task-1]/runnable@ForkJoinPool-1-worker-2
2026-11-22T10:36:20.040-06:00  INFO 95 --- [asincrono] [         task-2] com.ejemplo.asincrono.Paqueterias        : Cotizando con Envíos del Bajío en el hilo VirtualThread[#65,task-2]/runnable@ForkJoinPool-1-worker-3
2026-11-22T10:36:20.040-06:00  INFO 95 --- [asincrono] [         task-3] com.ejemplo.asincrono.Paqueterias        : Cotizando con Rápido Sur en el hilo VirtualThread[#67,task-3]/runnable@ForkJoinPool-1-worker-4

Tardó poco más de un segundo, no tres, y el registro muestra las tres cotizaciones empezando en el mismo instante, cada una en su propio hilo virtual (VirtualThread). Así se ve el mismo código sin @Async:

terminal$ curl -s -w "  (%{time_total} s)\n" localhost:8080/envio/mas-barato
{"paqueteria":"Envíos del Bajío","costo":149.50}  (3.124974 s)
registro de la aplicación2026-11-22T10:36:19.508-06:00  INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias        : Cotizando con Paquetería Norte en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-1
2026-11-22T10:36:20.511-06:00  INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias        : Cotizando con Envíos del Bajío en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-1
2026-11-22T10:36:21.511-06:00  INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias        : Cotizando con Rápido Sur en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-2

Tres segundos, una tras otra, todas en el hilo de la petición.

Las reglas de @Async. Como @Transactional y @Cacheable, funciona con un proxy: el método debe ser público y llamarse desde otro bean; desde la misma clase se ejecuta en el mismo hilo, sin aviso (lo explicamos en las rarezas). Si el método asíncrono lanza una excepción, llega dentro del CompletableFuture y la recibes al hacer join(). Y si es void, la excepción solo queda en el registro: nadie más se entera.

Cada proyecto de esta página se compiló con Spring Boot 4.2.0, Java 25 (Temurin 25.0.5.1) y Maven 3.10.1 en un contenedor limpio y sin red, se arrancó y se probó con las peticiones de curl que ves; las respuestas y los registros están copiados de esa ejecución.