Requisições para um endpoint travam para sempre enquanto o resto do serviço está bem. Como você diagnostica?

Tire um thread dump com jstack ou jcmd, de preferência dois com alguns segundos de diferença, e olhe as threads travadas. A JVM detecta ciclos de lock e imprime uma seção de Java level deadlock direto. Se não há ciclo, as threads provavelmente estão bloqueadas num recurso como um pool de conexões ou uma leitura de socket sem timeout. Corrija ordenando os locks de forma consistente, encurtando a seção crítica ou adicionando timeouts.

A primeira coisa é um thread dump, e eu tiro dois ou três com alguns segundos de diferença para distinguir o que está genuinamente travado do que só está ocupado. A JVM faz boa parte do trabalho aqui: se duas threads seguram os monitores uma da outra, ela imprime uma seção de Java level deadlock nomeando as duas threads e os dois locks, e aí os stack traces me dizem exatamente quais métodos olhar. Se não há ciclo, o padrão costuma ser diferente: dezenas de threads em estado de espera no mesmo pool de conexões, o que significa que algo está segurando conexões em vez de um deadlock clássico, ou threads bloqueadas numa leitura de socket sem timeout configurado, o que trava indefinidamente quando o outro lado para de responder. Para prevenção eu tenho algumas regras. Locks são adquiridos numa ordem consistente, e eu documento essa ordem quando há dois. Eu mantenho a seção crítica o menor possível e nunca faço uma chamada de rede nem publico mensagem segurando um lock. E onde o design permite eu uso tryLock com timeout, para que a contenção degrade em erro tratado em vez de travamento.