Las peticiones a un endpoint se quedan colgadas para siempre mientras el resto del servicio va bien. ¿Cómo lo diagnosticas?

Toma un volcado de hilos con jstack o jcmd, idealmente dos separados por unos segundos, y mira los hilos atascados. La JVM detecta los ciclos de locks e imprime directamente una sección de deadlock a nivel de Java. Si no hay ciclo, probablemente los hilos están bloqueados esperando un recurso como un pool de conexiones o una lectura de socket sin timeout. Se arregla ordenando los locks de forma consistente, reduciendo la sección crítica, o añadiendo timeouts.

Lo primero es un volcado de hilos, y tomo dos o tres separados por unos segundos para distinguir lo que está de verdad atascado de lo que solo está ocupado. La JVM hace buena parte del trabajo aquí: si dos hilos sostienen el monitor del otro, imprime una sección de deadlock a nivel de Java nombrando ambos hilos y ambos locks, y luego las trazas me dicen exactamente qué métodos mirar. Si no hay ciclo, el patrón suele ser distinto: docenas de hilos en estado waiting sobre el mismo pool de conexiones, lo que significa que algo está reteniendo conexiones y no un deadlock clásico, o hilos bloqueados en una lectura de socket sin timeout configurado, que se cuelga indefinidamente cuando el otro extremo deja de responder. Para prevenirlo tengo unas cuantas reglas. Los locks se adquieren en un orden consistente, y documento ese orden cuando hay dos. Mantengo la sección crítica lo más pequeña posible y nunca hago una llamada de red ni publico un mensaje sosteniendo un lock. Y donde el diseño lo permite uso tryLock con timeout, así la contención degrada a un error manejado en vez de a un cuelgue.