...
Eroare Go · fmt, CSV, XML și template-uri

expected element type <comanda> but have <order>

Pe scurt

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ă

Greșit
GO
type Comanda struct {
	XMLName xml.Name `xml:"comanda"`
	ID      int      `xml:"id"`
}
// document: <order><id>7</id></order>
Corect
GO
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

Greșit
GO
// <raspuns><order><id>7</id></order></raspuns>
var c Comanda
err := xml.Unmarshal(date, &c)
Corect
GO
var r struct {
	Comanda Comanda `xml:"order"`
}
err := xml.Unmarshal(date, &r)

Un struct pentru înveliș descrie structura reală a documentului.

Repară tu

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 produse
Codul care dă eroarea
GO
package 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))
}
După reparație, programul afișează
Comanda 7: 3 produse
Indiciu

Schimbă tag-ul câmpului XMLName în xml:"order".

Alte forme ale mesajului

  • XML syntax error on line 1: unexpected EOF
  • XML 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

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