encoding/hex: invalid byte: U+0078 'x'
hex.DecodeString a găsit un caracter care nu e cifră hexazecimală (0-9, a-f, A-F): de obicei prefixul 0x, un # de culoare, spații sau două puncte între octeți. Curăță textul înainte (strings.TrimPrefix, strings.ReplaceAll) și decodează doar cifrele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
hex.DecodeString transformă perechi de cifre hexazecimale în octeți: "ff00aa" devine [255 0 170]. Orice alt caracter oprește decodarea cu encoding/hex: invalid byte: U+0078 'x', unde U+0078 este codul Unicode al caracterului, iar între apostrofuri vezi caracterul însuși ('x', '#', ' ', ':').
Aproape mereu, textul are o „decorație” care nu ține de valoare: 0x în față (cum scrii în cod), # la culorile CSS, spații sau : între octeți (adrese MAC, amprente de certificate), un \n la final dintr-un fișier. O variantă înrudită este encoding/hex: odd length hex string: numărul de cifre e impar, deci ultimul octet e incomplet (de obicei pentru că ai tăiat un caracter în plus sau lipsește un zero în față).
De ce apare: cauzele frecvente
1Prefixul 0x lăsat în text
b, err := hex.DecodeString("0xff00aa")b, err := hex.DecodeString(strings.TrimPrefix("0xff00aa", "0x"))0x e o notație pentru oameni și pentru cod; DecodeString vrea doar cifrele.
2Culoare CSS cu #
rgb, err := hex.DecodeString("#1e90ff")rgb, err := hex.DecodeString(strings.TrimPrefix("#1e90ff", "#"))După ce scoți #, rămân 6 cifre, adică exact 3 octeți: roșu, verde, albastru.
3Separatori între octeți
mac, err := hex.DecodeString("00:1a:2b:3c:4d:5e")mac, err := hex.DecodeString(strings.ReplaceAll("00:1a:2b:3c:4d:5e", ":", ""))Separatorii nu sunt cifre hex; îi elimini, apoi decodezi șirul continuu.
Repară eroarea, direct în pagină
Programul transformă culori scrise în stil CSS (#ff8800) sau ca în cod (0x1e90ff) în componente RGB, dar se oprește cu encoding/hex: invalid byte: U+0023 '#'. Scoate prefixele înainte de decodare, ca programul să afișeze:
#ff8800 -> R=255 G=136 B=0
0x1e90ff -> R=30 G=144 B=255package main
import (
"encoding/hex"
"fmt"
)
func rgb(culoare string) ([]byte, error) {
return hex.DecodeString(culoare)
}
func main() {
for _, c := range []string{"#ff8800", "0x1e90ff"} {
b, err := rgb(c)
if err != nil {
panic(err)
}
fmt.Printf("%s -> R=%d G=%d B=%d\n", c, b[0], b[1], b[2])
}
}#ff8800 -> R=255 G=136 B=0 0x1e90ff -> R=30 G=144 B=255
Indiciu
strings.TrimPrefix scoate un prefix doar dacă există; aplică-l pentru # și pentru 0x.
Reparația
package main
import (
"encoding/hex"
"fmt"
"strings"
)
func rgb(culoare string) ([]byte, error) {
culoare = strings.TrimPrefix(culoare, "#")
culoare = strings.TrimPrefix(culoare, "0x")
return hex.DecodeString(culoare)
}
func main() {
for _, c := range []string{"#ff8800", "0x1e90ff"} {
b, err := rgb(c)
if err != nil {
panic(err)
}
fmt.Printf("%s -> R=%d G=%d B=%d\n", c, b[0], b[1], b[2])
}
}De ce merge
hex.DecodeString acceptă doar cifre hexazecimale, așa că # (U+0023) și x din 0x opreau decodarea. strings.TrimPrefix scoate prefixul doar când e prezent, deci aceeași funcție merge pentru ambele forme. Rămân câte 6 cifre, adică 3 octeți: ff = 255, 88 = 136, 00 = 0.
Alte forme ale mesajului
encoding/hex: invalid byte: U+0023 '#'encoding/hex: invalid byte: U+0020 ' 'encoding/hex: invalid byte: U+003A ':'encoding/hex: odd length hex string
Cum o eviți pe viitor
Normalizează textul hex chiar la intrare: strings.TrimSpace, apoi scoate prefixele (0x, #) și separatorii (:, -, spații). Verifică lungimea: un hash SHA-256 are 64 de caractere, o culoare 6. La afișare folosește hex.EncodeToString (fără prefix), ca să produci și tu formatul pe care îl citești. Raportează erorile cu valoarea primită (%q), ca să vezi caracterele invizibile.
Întrebări frecvente
Ce înseamnă U+0078?
Este codul Unicode al caracterului, în hexazecimal. U+0078 e litera x, U+0023 e #, U+0020 e spațiul, U+000A e linia nouă.
Cum citesc un număr scris ca 0xff, nu niște octeți?
Cu strconv.ParseInt(s, 0, 64): baza 0 recunoaște singură prefixele 0x, 0o și 0b. encoding/hex e pentru șiruri de octeți, nu pentru un singur număr.
Erori înrudite
illegal base64 data at input byte 15 Textul nu e base64 valid pentru codificarea folosită. Cel mai des decodezi cu StdEncoding un text în varianta pentru URL (cu - și _ în loc de + și /, de obicei fără = la final, ca în JWT), sau textul are spații, linii noi ori un prefix ca data:image/png;base64,. Alege codificarea potrivită (RawURLEncoding) sau curăță textul. strconv.Atoi: parsing "12a": invalid syntax Textul trimis la strconv.Atoi nu este un număr întreg valid: conține litere, spații, zecimale sau e gol. Curăță textul înainte (strings.TrimSpace), folosește ParseFloat pentru zecimale și tratează întotdeauna eroarea întoarsă. 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.
