expected element type <comanda> but have <order>
xml.Unmarshal a găsit alt element rădăcină decât cel cerut de câmpul XMLName al struct-ului. Potrivește tag-ul (xml:"order") cu documentul primit sau scoate XMLName dacă nu vrei verificarea numelui.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La xml.Unmarshal, dacă struct-ul are un câmp XMLName xml.Name cu tag (xml:"comanda"), Go verifică numele elementului rădăcină. Când documentul începe cu alt element, refuză și spune ce aștepta și ce a găsit: expected element type <comanda> but have <order>.
Apare când API-ul furnizorului folosește alte nume (engleză în loc de română, singular în loc de plural), când documentul are un element înveliș în plus (<raspuns><comanda>...), sau când ai copiat struct-ul de la alt endpoint.
Alte erori din aceeași familie: XML syntax error on line 1: unexpected EOF (document trunchiat), XML syntax error on line 3: element <id> closed by </comanda> (tag neînchis). Spre deosebire de JSON, câmpurile care nu se potrivesc nu dau eroare: rămân pur și simplu goale, deci verifică și valorile.
De ce apare: cauzele frecvente
1Nume diferit al elementului rădăcină
type Comanda struct {
XMLName xml.Name `xml:"comanda"`
ID int `xml:"id"`
}
// document: <order><id>7</id></order>type Comanda struct {
XMLName xml.Name `xml:"order"`
ID int `xml:"id"`
}Tag-ul lui XMLName trebuie să fie numele elementului din document.
2Element înveliș în plus
// <raspuns><order><id>7</id></order></raspuns>
var c Comanda
err := xml.Unmarshal(date, &c)var r struct {
Comanda Comanda `xml:"order"`
}
err := xml.Unmarshal(date, &r)Un struct pentru înveliș descrie structura reală a documentului.
Repară eroarea, direct în pagină
Programul citește o comandă trimisă de un furnizor în XML. Struct-ul cere elementul <comanda>, dar furnizorul trimite <order>, iar xml.Unmarshal întoarce expected element type <comanda> but have <order>. Potrivește tag-ul cu documentul, ca programul să afișeze:
Comanda 7: 3 produsepackage main
import (
"encoding/xml"
"fmt"
"log"
)
type Comanda struct {
XMLName xml.Name `xml:"comanda"`
ID int `xml:"id"`
Produse []string `xml:"item"`
}
const document = `<order><id>7</id><item>mouse</item><item>cablu</item><item>monitor</item></order>`
func main() {
var c Comanda
if err := xml.Unmarshal([]byte(document), &c); err != nil {
log.Fatal(err)
}
fmt.Printf("Comanda %d: %d produse\n", c.ID, len(c.Produse))
}Comanda 7: 3 produse
Indiciu
Schimbă tag-ul câmpului XMLName în xml:"order".
Reparația
package main
import (
"encoding/xml"
"fmt"
"log"
)
type Comanda struct {
XMLName xml.Name `xml:"order"`
ID int `xml:"id"`
Produse []string `xml:"item"`
}
const document = `<order><id>7</id><item>mouse</item><item>cablu</item><item>monitor</item></order>`
func main() {
var c Comanda
if err := xml.Unmarshal([]byte(document), &c); err != nil {
log.Fatal(err)
}
fmt.Printf("Comanda %d: %d produse\n", c.ID, len(c.Produse))
}De ce merge
Câmpul XMLName cu tag face ca Unmarshal să verifice numele elementului rădăcină. Documentul începe cu <order>, deci tag-ul trebuie să fie order. Restul câmpurilor se potrivesc după numele elementelor: <id> merge în ID, iar fiecare <item> se adaugă în slice-ul Produse.
Alte forme ale mesajului
XML syntax error on line 1: unexpected EOFXML syntax error on line 3: element <id> closed by </comanda>expected element type <produse> but have <produs>
Cum o eviți pe viitor
Scrie struct-urile pornind de la un document real primit de la API, nu din documentație, și păstrează un exemplu în teste. Folosește XMLName doar când vrei verificarea numelui. După Unmarshal, validează câmpurile obligatorii (id nenul, dată completată), pentru că XML-ul ignoră în tăcere elementele cu alt nume.
Întrebări frecvente
De ce câmpurile mele rămân goale, fără eroare?
Pentru că encoding/xml potrivește doar elementele cu numele din tag și ignoră restul. Verifică tag-urile (sensibile la litere mari) și namespace-urile.
Cum citesc un atribut, de exemplu <order id="7">?
Cu ,attr în tag: ID int xml:"id,attr"``.
Erori înrudite
json: cannot unmarshal string into Go struct field Produs.pret of type float64 În JSON câmpul pret este un text ("12.5"), dar în struct l-ai declarat float64. Fie corectezi JSON-ul să trimită număr (12.5), fie adaugi opțiunea ,string în tag (json:"pret,string"), fie declari câmpul string și îl convertești tu. unexpected end of JSON input Textul JSON s-a terminat înainte să fie complet: lipsește o acoladă sau o paranteză de închidere, textul e trunchiat sau e chiar gol. Verifică ce primești în date (afișează-l), închide toate { și [ și tratează separat cazul în care corpul e gol. json: unknown field "price" Ai activat DisallowUnknownFields pe json.Decoder, iar JSON-ul conține o cheie care nu corespunde niciunui câmp din struct (de multe ori o greșeală de nume sau un tag json diferit). Corectează cheia, adaugă câmpul cu tag-ul potrivit, sau renunță la verificarea strictă. Î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.
