404 Not Found (nginx, de la ingress-nginx)
Cererea a ajuns la controllerul ingress-nginx, dar nicio regulă nu se potrivește cu hostul sau calea cerută, așa că răspunde backend-ul implicit cu 404. Verifică host-ul și path-ul din Ingress față de URL-ul folosit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Controllerul de Ingress primește cererile pentru toate site-urile și alege regula după antetul Host și după cale. Dacă niciuna nu se potrivește, răspunde cu pagina proprie 404 Not Found (nginx), fără să ajungă la vreo aplicație.
Cauze: hostul din Ingress diferă de cel din browser (magazin.local față de www.magazin.local), calea are pathType: Exact și ceri o subpagină, Ingress-ul nu are ingressClassName și controllerul îl ignoră, ori Ingress-ul e în alt namespace decât serviciul (backend-ul trebuie să fie în același namespace).
Dacă 404-ul are aspectul paginii aplicației, nu al lui nginx, regula s-a potrivit, iar aplicația însăși nu are pagina: e altă problemă.
De ce apare: cauzele frecvente
1Host diferit
rules:
- host: magazin.local # utilizatorii intră pe www.magazin.localrules:
- host: magazin.local
...
- host: www.magazin.local
...Fiecare host primește regula lui.
2pathType Exact
path: /
pathType: Exactpath: /
pathType: PrefixExact potrivește doar calea exactă, nu și subpaginile.
3Lipsește ingressClassName
spec:
rules: ...spec:
ingressClassName: nginx
rules: ...Fără clasă, controllerul poate ignora Ingress-ul.
Repară eroarea, direct în pagină
O florărie e publicată prin Ingress-ul flori pe hostul flori.local, dar clienții intră și pe www.flori.local, unde primesc 404 Not Found. Adaugă în Ingress și hostul www.flori.local, către același serviciu flori:80.
Indiciu
kubectl create ingress ... --rule=... --rule=... --dry-run=client -o yaml | kubectl apply -f -.
Reparația
Hostul fără regulă:
curl -s http://www.flori.local | grep title<head><title>404 Not Found</title></head>Adaugă hostul:
kubectl create ingress flori --class=nginx --rule='flori.local/*=flori:80' --rule='www.flori.local/*=flori:80' --dry-run=client -o yaml | kubectl apply -f -
k8ssim avans 5
curl -s -o /dev/null -w '%{http_code}\n' http://www.flori.localingress.networking.k8s.io/flori configured
Au trecut 5 secunde (ora clusterului: 10:00:39).
200De ce merge
Controllerul alege regula după hostul cerut, iar www.flori.local nu avea nicio regulă, deci răspundea backend-ul implicit cu 404. Cu a doua regulă, ambele hosturi duc la serviciul flori. Recreat prin --dry-run | apply, Ingress-ul e actualizat pe loc, fără întrerupere pentru hostul existent.
Alte forme ale mesajului
<html><head><title>404 Not Found</title></head><body><center><h1>404 Not Found</h1></center><hr><center>nginx</center>
Cum o eviți pe viitor
- Listează toate hosturile reale ale site-ului (cu și fără
www) în Ingress. - Folosește
pathType: Prefixpentru site-uri cu subpagini. - Pune mereu
ingressClassName. - Testează cu
curl -H 'Host: ...' http://IPcând DNS-ul nu e încă gata. - Verifică
kubectl describe ingressdupă fiecare schimbare: arată regulile exact cum le vede controllerul.
Întrebări frecvente
Cum știu dacă 404-ul vine de la Ingress sau de la aplicație?
Pagina controllerului are subsolul nginx. Dacă e pagina aplicației, regula s-a potrivit.
Pot avea un backend implicit pentru orice host?
Da, cu spec.defaultBackend, dar de obicei e mai clar să listezi hosturile explicit.
Erori înrudite
503 Service Temporarily Unavailable ingress-nginx a găsit regula, dar serviciul din spate nu are niciun pod pregătit (endpoint-uri goale), nu există sau portul din Ingress nu e un port al serviciului. Verifică kubectl get endpoints pentru serviciul din backend și numele și portul din regulă. 502 Bad Gateway Controllerul de Ingress a găsit podurile, dar conexiunea la ele a eșuat: de obicei targetPort-ul serviciului nu e portul aplicației, sau aplicația cade în timpul cererii. Corectează targetPort-ul și verifică jurnalele podurilor. wget: bad address 'catalog-api' Numele cerut nu există în DNS-ul clusterului: nu există niciun serviciu cu acest nume în namespace-ul podului. Creează serviciul (kubectl expose) sau folosește numele exact al serviciului existent. Î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.
