...
Eroare Go · strconv și JSON

encoding/hex: invalid byte: U+0078 'x'

Pe scurt

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

Greșit
GO
b, err := hex.DecodeString("0xff00aa")
Corect
GO
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 #

Greșit
GO
rgb, err := hex.DecodeString("#1e90ff")
Corect
GO
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

Greșit
GO
mac, err := hex.DecodeString("00:1a:2b:3c:4d:5e")
Corect
GO
mac, err := hex.DecodeString(strings.ReplaceAll("00:1a:2b:3c:4d:5e", ":", ""))

Separatorii nu sunt cifre hex; îi elimini, apoi decodezi șirul continuu.

Repară tu

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=255
Codul care dă eroarea
GO
package 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])
	}
}
După reparație, programul afișează
#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.

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

← 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.