java.net.SocketTimeoutException: Read timed out
Conexiunea s-a deschis, dar serverul nu a trimis niciun răspuns în timpul permis (read timeout). Serverul e lent, blocat sau timeout-ul e prea mic. Mărește timeout-ul dacă e cazul și tratează excepția: reîncercare sau mesaj clar.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un client de rețea are de obicei două limite: connect timeout (cât aștepți deschiderea conexiunii) și read timeout (cât aștepți date după ce ai trimis cererea). Read timed out înseamnă că a doua limită a expirat: serverul a acceptat conexiunea, dar n-a trimis nimic la timp.
Cauze frecvente: o interogare lentă la baza de date pe server, un serviciu extern supraîncărcat, un server blocat (deadlock), un timeout setat prea mic (de exemplu 1 secundă pentru un raport care durează 10) sau un proxy care ține conexiunea deschisă fără să răspundă.
Același tip de excepție apare cu mesajul Connect timed out (nu s-a putut deschide conexiunea la timp). În OkHttp / Retrofit vezi java.net.SocketTimeoutException: timeout, iar în Ktor SocketTimeoutException sau HttpRequestTimeoutException.
De ce apare: cauzele frecvente
1Server care nu răspunde la timp
client.soTimeout = 200
val r = client.getInputStream().read()client.soTimeout = 200
val r = try { client.getInputStream().read() } catch (e: SocketTimeoutException) { -1 }Tratezi explicit cazul în care răspunsul nu vine la timp.
2Timeout prea mic pentru o operație lungă
val c = URI(url).toURL().openConnection()
c.readTimeout = 1000val c = URI(url).toURL().openConnection()
c.readTimeout = 15000Pentru rapoarte sau exporturi lente, limita trebuie să fie pe măsura operației.
3Niciun timeout setat
val c = URI(url).toURL().openConnection()
c.getInputStream()val c = URI(url).toURL().openConnection()
c.connectTimeout = 5000
c.readTimeout = 10000
c.getInputStream()Fără limite, aplicația poate aștepta la nesfârșit; cu limite, primești o excepție pe care o poți trata.
Repară eroarea, direct în pagină
Clientul se conectează la un server care nu trimite niciun răspuns și, după 200 ms, programul se oprește cu SocketTimeoutException: Read timed out. Prinde excepția în jurul citirii și afișează Serverul nu a raspuns la timp.
import java.net.ServerSocket
import java.net.Socket
import java.net.SocketTimeoutException
fun main() {
val server = ServerSocket(0)
val client = Socket("localhost", server.localPort)
client.soTimeout = 200
val raspuns = client.getInputStream().read()
println("Primit: $raspuns")
}Serverul nu a raspuns la timp
Indiciu
Pune read() într-un try și prinde SocketTimeoutException (importul există deja).
Reparația
import java.net.ServerSocket
import java.net.Socket
import java.net.SocketTimeoutException
fun main() {
val server = ServerSocket(0)
val client = Socket("localhost", server.localPort)
client.soTimeout = 200
try {
val raspuns = client.getInputStream().read()
println("Primit: $raspuns")
} catch (e: SocketTimeoutException) {
println("Serverul nu a raspuns la timp")
}
}De ce merge
soTimeout = 200 stabilește cât așteaptă read() date de la server. Serverul acceptă conexiunea, dar nu scrie nimic, deci după 200 ms citirea aruncă SocketTimeoutException. Fără limită, programul ar fi așteptat la nesfârșit. Cu try/catch, timeout-ul devine un caz tratat, iar programul poate afișa un mesaj sau reîncerca.
Alte forme ale mesajului
Exception in thread "main" java.net.SocketTimeoutException: Read timed outjava.net.SocketTimeoutException: Connect timed outjava.net.SocketTimeoutException: timeoutjava.net.SocketTimeoutException: connect timed out
Cum o eviți pe viitor
Setează mereu explicit connect timeout și read timeout la clienții HTTP și la conexiunile la baza de date. Alege valorile după operație și loghează durata cererilor lente. La apeluri către servicii externe, adaugă reîncercări cu pauză crescătoare doar pentru operații sigure de repetat (citiri, cereri idempotente).
Întrebări frecvente
E vina mea sau a serverului?
De obicei serverul e lent sau blocat, dar și un timeout nerealist de mic din client poate fi cauza. Verifică în log-urile serverului cât a durat cererea.
E sigur să reîncerc automat?
Pentru citiri, da. Pentru operații care modifică date (plăți, comenzi), o reîncercare poate executa operația de două ori; folosește chei de idempotență sau verifică starea înainte.
Erori înrudite
java.net.ConnectException: Connection refused Calculatorul la care te conectezi a răspuns, dar niciun program nu ascultă pe portul acela: serverul (API-ul, baza de date) nu e pornit, ascultă pe alt port sau doar pe altă interfață. Verifică portul și pornește serviciul înainte să te conectezi. kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 ms Codul din withTimeout(100) { ... } n-a terminat în 100 ms, așa că a fost anulat și s-a aruncat excepția. Mărește limita dacă e prea mică, folosește withTimeoutOrNull (care dă null în loc de excepție) sau prinde excepția și tratează cazul. java.net.BindException: Address already in use Serverul tău încearcă să pornească pe un port ocupat deja de alt program, de obicei o instanță veche a aceleiași aplicații rămasă pornită. Oprește procesul vechi sau pornește serverul pe alt port. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
