...
Eroare Go · HTTP și URL-uri

invalid URL escape "%"

Pe scurt

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

Greșit
GO
adresa := "https://magazin.ro/cauta?q=" + text
// text = "reducere 50%"
Corect
GO
q := url.Values{"q": {text}}
adresa := "https://magazin.ro/cauta?" + q.Encode()
// q=reducere+50%25

Encode codifică fiecare valoare, deci % devine %25, iar spațiul devine +.

2Text cu % în calea URL-ului

Greșit
GO
u, err := url.Parse("https://magazin.ro/categorie/50%-reducere")
Corect
GO
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ă tu

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%
Codul care dă eroarea
GO
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"))
}
După reparație, programul afișează
URL: /cauta?q=reducere+50%25
Caut: reducere 50%
Indiciu

q := url.Values{"q": {text}} și adresa := "/cauta?" + q.Encode().

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

← Toate erorile Go

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ță 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.