"Timeout expired" no SQL Server: por que acontece e como investigar

Mensagem recebida na aplicação: "Timeout expired. The timeout period elapsed prior to completion of the operation or the server is not responding." Diferente dos outros erros deste glossário, este não é uma mensagem numerada do motor do SQL Server (Msg NNNN) — é uma exceção do driver cliente (SqlException, ADO.NET/Microsoft.Data.SqlClient), disparada quando o comando não termina dentro do CommandTimeout configurado na conexão (padrão: 30 segundos).

Dois timeouts diferentes, dois problemas diferentes

"Connection Timeout Expired" (ao abrir a conexão) é outro erro — servidor inacessível, pool de conexões esgotado, firewall/DNS. Este artigo é sobre o timeout de comando: a conexão abriu normalmente, mas a query em execução não voltou a tempo.

O que investigar primeiro

Não é bug do driver — a query genuinamente não terminou dentro da janela de espera do cliente. Os dois suspeitos mais comuns: alguém está bloqueando essa sessão, ou o plano de execução da query degradou. Comece checando bloqueio:

SELECT
  r.session_id AS sessao_bloqueada,
  r.blocking_session_id AS sessao_bloqueadora,
  r.wait_type, r.wait_time
FROM sys.dm_exec_requests r
WHERE r.blocking_session_id <> 0;

Causas mais comuns

• Sessão bloqueada por outra transação segurando lock por tempo demais.
• Regressão de plano de execução — estatística desatualizada ou parameter sniffing fazendo o otimizador escolher um plano ruim.
• CommandTimeout configurado baixo demais pra uma operação legitimamente pesada (relatório, batch, migração).
• Servidor sob pressão de CPU/memória, sem folga pra responder dentro da janela do cliente.

O codeDB identifica queries que regrediram e sugere índice automaticamente — em vez de esperar a aplicação começar a estourar timeout pra alguém ir investigar.