invalid URL escape "%"
Un text cu % (sau alte caractere speciale) a fost pus într-un URL fără codificare, iar la citire % trebuie urmat de două cifre hex (%20, %25). Construiește parametrii cu url.Values{...}.Encode() sau url.QueryEscape, nu prin concatenare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-un URL, % introduce un caracter codificat: %20 este spațiu, %25 este chiar %, %C8%99 este ș. Când funcțiile de decodare (url.QueryUnescape, url.PathUnescape, url.ParseQuery, url.Parse pentru cale) găsesc un % care nu e urmat de două cifre hexazecimale, se opresc cu invalid URL escape "%" (sau "%zz", "%2", cu fragmentul problematic între ghilimele).
Aproape mereu cauza este un text pus direct în URL prin concatenare: "/cauta?q=" + text, iar textul conține % („reducere 50%”), spații, & sau #. Unele caractere strică URL-ul fără eroare (& începe alt parametru, # taie restul).
Atenție: r.URL.Query() și u.Query() ignoră în tăcere perechile invalide; doar url.ParseQuery îți arată eroarea.
De ce apare: cauzele frecvente
1Parametri lipiți prin concatenare
adresa := "https://magazin.ro/cauta?q=" + text
// text = "reducere 50%"q := url.Values{"q": {text}}
adresa := "https://magazin.ro/cauta?" + q.Encode()
// q=reducere+50%25Encode codifică fiecare valoare, deci % devine %25, iar spațiul devine +.
2Text cu % în calea URL-ului
u, err := url.Parse("https://magazin.ro/categorie/50%-reducere")u := &url.URL{Scheme: "https", Host: "magazin.ro",
Path: "/categorie/50%-reducere"}
adresa := u.String()Când setezi Path pe struct, String() codifică singur caracterele speciale.
Repară eroarea, direct în pagină
Programul construiește adresa unei căutări și o verifică așa cum ar face serverul. Textul căutat conține % și e lipit direct în URL, iar url.ParseQuery se oprește cu invalid URL escape "%". Construiește parametrii cu url.Values, ca programul să afișeze:
URL: /cauta?q=reducere+50%25
Caut: reducere 50%package main
import (
"fmt"
"log"
"net/url"
)
func main() {
text := "reducere 50%"
adresa := "/cauta?q=" + text
u, err := url.Parse(adresa)
if err != nil {
log.Fatal(err)
}
valori, err := url.ParseQuery(u.RawQuery)
if err != nil {
log.Fatal(err)
}
fmt.Println("URL:", adresa)
fmt.Println("Caut:", valori.Get("q"))
}URL: /cauta?q=reducere+50%25 Caut: reducere 50%
Indiciu
q := url.Values{"q": {text}} și adresa := "/cauta?" + q.Encode().
Reparația
package main
import (
"fmt"
"log"
"net/url"
)
func main() {
text := "reducere 50%"
q := url.Values{"q": {text}}
adresa := "/cauta?" + q.Encode()
u, err := url.Parse(adresa)
if err != nil {
log.Fatal(err)
}
valori, err := url.ParseQuery(u.RawQuery)
if err != nil {
log.Fatal(err)
}
fmt.Println("URL:", adresa)
fmt.Println("Caut:", valori.Get("q"))
}De ce merge
În URL, % trebuie urmat de două cifre hex, iar textul lipit direct avea un % singur la final. url.Values.Encode() codifică valoarea: spațiul devine +, iar % devine %25. La decodare, ParseQuery face drumul invers și obține exact textul inițial, pe care serverul îl poate folosi în căutare.
Alte forme ale mesajului
invalid URL escape "%zz"parse "https://magazin.ro/categorie/50%-reducere": invalid URL escape "%-r"invalid URL escape "%2"
Cum o eviți pe viitor
Nu construi URL-uri prin concatenare de text. Pentru parametri folosește url.Values și Encode(), pentru segmente de cale url.PathEscape sau url.JoinPath, iar pentru URL-ul întreg url.URL{...}.String(). La server, când validarea contează, citește parametrii cu url.ParseQuery(r.URL.RawQuery) și tratează eroarea.
Întrebări frecvente
Care e diferența dintre QueryEscape și PathEscape?
QueryEscape codifică spațiul ca + și e pentru valorile parametrilor. PathEscape îl codifică %20 și lasă neatinse caracterele permise într-un segment de cale.
De ce r.URL.Query() nu dă eroare?
Pentru că ignoră perechile pe care nu le poate decoda, ca să nu oprească o cerere pentru un parametru neimportant. Dacă vrei eroarea, folosește url.ParseQuery.
Erori înrudite
parse "https://api.exemplu.ro/produse\n": net/url: invalid control character in URL URL-ul conține un caracter de control, aproape mereu un \n sau \r rămas la final după citirea dintr-un fișier, din stdin sau dintr-o variabilă de mediu. Curăță valoarea cu strings.TrimSpace înainte de url.Parse sau http.NewRequest. Get "localhost:8080/api": unsupported protocol scheme "localhost" URL-ul dat clientului HTTP nu începe cu http:// sau https://. Fără schemă, Go interpretează "localhost:" ca schemă (sau găsește o schemă goală) și refuză cererea. Adaugă http:// în fața adresei. unknown escape Ai un backslash urmat de o literă care nu e o secvență de escape validă, de obicei "\d" sau "\s" într-o expresie regulată sau o cale Windows. Scrie șirul între backticks (`\d+`) sau dublează backslash-ul ("\\d+"). Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
