Error: write EPROTO ... SSL routines:ssl3_get_record:wrong version number
Ai trimis o cerere HTTPS spre un port care vorbește HTTP simplu (sau spre un proxy greșit). Clientul așteaptă un handshake TLS și primește text HTTP. Folosește http:// pentru serverul fără TLS sau portul HTTPS corect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din OpenSSL. „Wrong version number” înseamnă că primii octeți primiți de la server nu arată a TLS: clientul a început un handshake HTTPS, iar serverul a răspuns, de fapt, cu HTTP simplu (de exemplu HTTP/1.1 400 Bad Request).
Cauze frecvente:
https://spre un server local care ascultă doar HTTP (https://localhost:3000);- port greșit:
https://api.magazin.test:80; - un proxy configurat cu
https://deși proxy-ul vorbește HTTP; - un environment copiat de pe alt mediu, cu protocolul schimbat.
E inversul erorii „The plain HTTP request was sent to HTTPS port”. Regula: protocolul și portul trebuie să se potrivească (https pe 443 sau pe portul TLS al serverului, http pe 80 sau pe portul HTTP).
De ce apare: cauzele frecvente
1HTTPS spre un server HTTP local
GET https://localhost:3000/healthGET http://localhost:3000/healthServerul de dezvoltare nu are TLS, deci trebuie folosit http.
2Port HTTP cu protocol HTTPS
GET https://api.magazin.test:80/healthGET https://api.magazin.test/healthFără port explicit, https folosește 443, unde serverul vorbește TLS.
3Proxy configurat cu https
Proxy: https://proxy.firma.ro:8080Proxy: http://proxy.firma.ro:8080Majoritatea proxy-urilor primesc conexiunea în HTTP simplu și deschid tunelul TLS după.
Repară eroarea, direct în pagină
Cererea „Health” are URL-ul https://api.magazin.test:80/health: protocol HTTPS pe portul HTTP, combinație care pe un server real dă EPROTO ... wrong version number. Scoate portul din URL, salvează cererea și trimite-o; trebuie să primești 200.
Indiciu
Fără port, https folosește portul standard 443.
Reparația
https://api.magazin.test/healthDe ce merge
Pe portul 80 serverul vorbește HTTP simplu, deci un client HTTPS primește text în loc de handshake TLS. Fără port explicit, https:// merge pe 443, unde serverul vorbește TLS. Simulatorul nu modelează porturile, așa că verificarea se face pe URL-ul salvat. Mesajul apare când clientul vorbește TLS cu un port care răspunde HTTP simplu. Cu protocolul potrivit portului, ambele părți folosesc aceeași „limbă”, iar cererea primește răspuns.
Alte forme ale mesajului
Error: write EPROTO 140735:error:1408F10B:SSL routines:ssl3_get_record:wrong version numberSSL routines:OPENSSL_internal:WRONG_VERSION_NUMBER
Cum o eviți pe viitor
- Nu scrie porturi în URL dacă nu e nevoie: protocolul își alege portul standard.
- Ține protocolul în
baseUrl, verificat o dată pentru fiecare mediu. - La servere locale, verifică în logul de pornire dacă ascultă pe http sau https.
Întrebări frecvente
De ce mesajul pomenește ssl3?
E numele intern al funcției din OpenSSL care citește înregistrările TLS; nu înseamnă că folosești SSL 3.
Ce înseamnă EPROTO?
Eroare de protocol: datele primite nu respectă protocolul așteptat, aici TLS.
Erori înrudite
400 The plain HTTP request was sent to HTTPS port Ai trimis cererea cu http:// spre un port pe care serverul (de obicei nginx) așteaptă HTTPS. Serverul răspunde 400 cu o pagină HTML. Schimbă protocolul în https:// sau scoate portul 443 din URL. Error: socket hang up Serverul (sau un proxy) a închis conexiunea înainte să trimită un răspuns complet. Cauze tipice: un antet Content-Length scris manual și greșit, HTTP trimis pe un port HTTPS, serverul care cade la cerere sau o limită de timp a proxy-ului. Verifică antetele manuale și logul serverului. Error: tunneling socket could not be established, cause=connect ECONNREFUSED 127.0.0.1:8888 Postman încearcă să treacă prin proxy-ul configurat (aici 127.0.0.1:8888), dar proxy-ul nu răspunde. Oprește proxy-ul din Settings → Proxy dacă nu ai nevoie de el, pornește-l (de exemplu Fiddler, Charles) sau corectează adresa proxy-ului firmei. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
