...
Eroare Kotlin · Fișiere, rețea și fire de execuție

java.net.SocketTimeoutException: Read timed out

Pe scurt

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

Greșit
KOTLIN
client.soTimeout = 200
val r = client.getInputStream().read()
Corect
KOTLIN
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ă

Greșit
KOTLIN
val c = URI(url).toURL().openConnection()
c.readTimeout = 1000
Corect
KOTLIN
val c = URI(url).toURL().openConnection()
c.readTimeout = 15000

Pentru rapoarte sau exporturi lente, limita trebuie să fie pe măsura operației.

3Niciun timeout setat

Greșit
KOTLIN
val c = URI(url).toURL().openConnection()
c.getInputStream()
Corect
KOTLIN
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ă tu

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.

Codul care dă eroarea
KOTLIN
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")
}
După reparație, programul afișează
Serverul nu a raspuns la timp
Indiciu

Pune read() într-un try și prinde SocketTimeoutException (importul există deja).

Alte forme ale mesajului

  • Exception in thread "main" java.net.SocketTimeoutException: Read timed out
  • java.net.SocketTimeoutException: Connect timed out
  • java.net.SocketTimeoutException: timeout
  • java.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

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.