java.lang.IllegalArgumentException: port out of range:70000
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 de8080); - portul și altă valoare citite în ordine inversă, de exemplu timeout-ul
30000folosit drept port și invers; -1folosit 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
int port = Integer.parseInt("80800");
InetSocketAddress a = new InetSocketAddress("localhost", port);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”
int port = config.getOrDefault("port", -1);
new ServerSocket(port);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ă 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.
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());
}
}Server: localhost:8080
Indiciu
Un port valid e între 0 și 65535.
Reparația
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", "8080");
int port = Integer.parseInt(config.get("port"));
InetSocketAddress adresa = InetSocketAddress.createUnresolved(config.get("host"), port);
System.out.println("Server: " + adresa.getHostString() + ":" + adresa.getPort());
}
}De ce merge
Portul e un număr pe 16 biți, deci 80800 nu poate exista, iar InetSocketAddress verifică asta înainte de orice altceva. Cu 8080, adresa se creează. createUnresolved nu face căutare DNS, deci programul nu are nevoie de rețea și doar afișează host-ul și portul.
Alte forme ale mesajului
java.lang.IllegalArgumentException: port out of range:-1java.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
java.lang.IllegalArgumentException: URI with undefined scheme HttpRequest a primit o adresă fără http:// sau https:// la început, deci nu știe ce protocol să folosească. Scrie adresa completă: URI.create("https://www.site.ro/api"). java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. java.net.MalformedURLException: no protocol: www.site.ro/api Adresa nu începe cu un protocol, de exemplu https://, așa că Java nu o poate transforma în URL. Scrie adresa completă (https://www.site.ro/api) și, în Java 20+, creeaz-o cu URI.create(...).toURL(). Î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.
