error: error parsing web.yaml: error converting YAML to JSON: yaml: line 8: found character that cannot start any token
Pe linia indicată e un caracter pe care YAML nu îl acceptă la început de valoare, aproape mereu un TAB folosit la indentare (YAML acceptă doar spații) sau un caracter special (@, `, %) fără ghilimele. Înlocuiește tab-urile cu spații și pune valorile speciale între ghilimele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Parserul YAML citește fiecare element începând cu primul caracter. Unele caractere nu pot deschide o valoare: tab-ul (YAML interzice tab-urile la indentare), backtick-ul, @ și % la început de valoare. Când dă peste unul, se oprește cu acest mesaj și numărul liniei.
Cel mai des vine dintr-un editor care pune tab-uri la apăsarea tastei Tab, din cod copiat dintr-o pagină web sau dintr-un fișier Makefile. Tab-ul nu se vede: arată ca niște spații. cat -A fișier afișează tab-urile ca ^I, iar grep -P '\t' fișier le găsește.
Pentru valori care încep cu @ (de exemplu un utilizator @admin), pune ghilimele.
De ce apare: cauzele frecvente
1Tab la indentare
- name: p
image: nginx:1.27 - name: p
image: nginx:1.27YAML acceptă doar spații pentru indentare.
2Valoare care începe cu @
value: @admin value: "@admin"@ e rezervat în YAML; între ghilimele devine text obișnuit.
3Backtick copiat din documentație
image: `nginx:1.27` image: nginx:1.27Backtick-urile din documentație marchează codul, nu fac parte din valoare.
Repară eroarea, direct în pagină
Manifestul ~/k8s/web.yaml al unui atelier de biciclete a fost editat într-un editor care pune tab-uri, iar kubectl apply dă found character that cannot start any token. Înlocuiește tab-ul cu spații, ca image să fie aliniat sub name, și aplică fișierul.
Indiciu
cat -A web.yaml arată tab-urile ca ^I.
Reparația
Parserul se oprește, iar cat -A arată tab-ul:
kubectl apply -f web.yaml || true
cat -A web.yaml | tail -2error: error parsing web.yaml: error converting YAML to JSON: yaml: line 8: found character that cannot start any token
- name: web$
^Iimage: nginx:1.27$Înlocuiește tab-ul cu spații:
sed -i 's/\t/ /' web.yaml
kubectl apply -f web.yaml
kubectl get pod webpod/web created
NAME READY STATUS RESTARTS AGE
web 0/1 ContainerCreating 0 2sDe ce merge
YAML permite doar spații la indentare. Tab-ul de pe linia image nu poate începe niciun element, deci parserul se oprește. Înlocuit cu patru spații, image ajunge aliniat cu name (ambele sunt câmpuri ale aceluiași container), iar podul se creează.
Alte forme ale mesajului
yaml: line 6: found character that cannot start any tokenerror converting YAML to JSON: yaml: line 3: found a tab character that violates indentation
Cum o eviți pe viitor
- Configurează editorul să insereze spații la Tab pentru fișierele .yaml (în VS Code e implicit).
- Activează afișarea caracterelor invizibile când lucrezi cu YAML.
- Rulează yamllint înainte de commit: găsește tab-urile și indentările inconsecvente.
- Nu copia YAML din pagini web fără să verifici după aceea caracterele invizibile.
Întrebări frecvente
Cum găsesc tab-urile într-un fișier?
Cu cat -A fișier (tab-urile apar ca ^I) sau cu grep -n -P '\t' fișier, care afișează și numărul liniei.
Pot înlocui toate tab-urile deodată?
Da: sed -i 's/\t/ /g' fișier le înlocuiește cu câte două spații. Verifică apoi alinierea, pentru că un tab poate valora altă lățime în editorul tău.
Erori înrudite
error: error parsing web.yaml: error converting YAML to JSON: yaml: line 11: mapping values are not allowed in this context YAML-ul are pe linia indicată un : nepermis: de obicei o valoare care conține „: ” fără ghilimele (Luni-Vineri: 9-18) sau o indentare greșită. Pune valoarea între ghilimele sau corectează indentarea și aplică din nou. error: error parsing web.yaml: error converting YAML to JSON: yaml: line 9: did not find expected '-' indicator Un element dintr-o listă YAML nu e aliniat: parserul aștepta un nou element care începe cu - sau o cheie la același nivel, dar a găsit altă indentare. Aliniază câmpurile containerului (name, image, ports) exact unul sub altul. Error from server (BadRequest): error when creating "web.yaml": Deployment in version "v1" cannot be handled as a Deployment: strict decoding error: unknown field "spec.template.spec.containers[0].imagePullPolicyy" Manifestul are un câmp pe care API-ul nu îl cunoaște: o greșeală de tastare (imagePullPolicyy) sau un câmp pus la nivelul greșit de indentare. Corectează numele sau mută câmpul, verificând cu kubectl explain. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
