...
Eroare Java · Reflecție, module și alte API-uri

java.lang.IllegalArgumentException: port out of range:70000

Pe scurt

Portul trimis la InetSocketAddress, Socket sau ServerSocket nu e între 0 și 65535. De obicei portul din configurare are o cifră în plus sau a fost citit greșit: corectează valoarea (de exemplu 8080) și valideaz-o la citire.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un port TCP sau UDP e un număr pe 16 biți, deci are valori între 0 și 65535. Clasele de rețea din Java (InetSocketAddress, Socket, ServerSocket, DatagramSocket) verifică numărul și, dacă e în afara intervalului, aruncă IllegalArgumentException: port out of range: urmat de valoare.

Cauzele obișnuite:

  • o greșeală de tastare în configurare (80800 în loc de 8080);
  • portul și altă valoare citite în ordine inversă, de exemplu timeout-ul 30000 folosit drept port și invers;
  • -1 folosit ca „nesetat” și trimis mai departe.

Excepția apare la crearea adresei sau a socket-ului, înainte de orice conexiune. Valoarea greșită apare chiar în mesaj, deci o poți căuta direct în fișierul de configurare.

De ce apare: cauzele frecvente

1Cifră în plus în configurare

Greșit
JAVA
int port = Integer.parseInt("80800");
InetSocketAddress a = new InetSocketAddress("localhost", port);
Corect
JAVA
int port = Integer.parseInt("8080");
InetSocketAddress a = new InetSocketAddress("localhost", port);

8080 e în intervalul 0–65535, deci adresa se poate crea.

2Valoare -1 pentru „nesetat”

Greșit
JAVA
int port = config.getOrDefault("port", -1);
new ServerSocket(port);
Corect
JAVA
int port = config.getOrDefault("port", 8080);
new ServerSocket(port);

Dă o valoare implicită validă, sau oprește aplicația cu un mesaj clar când portul lipsește.

Repară tu

Repară eroarea, direct în pagină

Programul construiește adresa serverului din configurare, dar portul are o cifră în plus și programul se oprește cu IllegalArgumentException: port out of range:80800. Corectează portul la 8080, ca programul să afișeze Server: localhost:8080.

Codul care dă eroarea
JAVA
import java.net.InetSocketAddress;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<String, String> config = Map.of("host", "localhost", "port", "80800");
        int port = Integer.parseInt(config.get("port"));
        InetSocketAddress adresa = InetSocketAddress.createUnresolved(config.get("host"), port);
        System.out.println("Server: " + adresa.getHostString() + ":" + adresa.getPort());
    }
}
După reparație, programul afișează
Server: localhost:8080
Indiciu

Un port valid e între 0 și 65535.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: port out of range:-1
  • java.lang.IllegalArgumentException: Port value out of range: 70000

Cum o eviți pe viitor

  • Validează portul imediat după citirea configurării: if (port < 1 || port > 65535) throw new IllegalArgumentException("port invalid: " + port);.
  • Folosește nume clare în configurare (server.port, client.timeoutMs) ca să nu încurci valorile.
  • Afișează la pornire adresa și portul pe care ascultă aplicația.

Întrebări frecvente

Ce înseamnă portul 0?

La new ServerSocket(0), sistemul alege singur un port liber. E util în teste. Pentru un server cunoscut de clienți, folosește un port fix.

De ce porturile sub 1024 dau altă eroare pe Linux?

Porturile 0–1023 sunt rezervate și cer drepturi de administrator. Acolo primești java.net.BindException: Permission denied, nu port out of range.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.