...
Eroare Kubernetes · Services, DNS, Ingress și port-forward

404 Not Found (nginx, de la ingress-nginx)

Pe scurt

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

Greșit
YAML
rules:
- host: magazin.local   # utilizatorii intră pe www.magazin.local
Corect
YAML
rules:
- host: magazin.local
  ...
- host: www.magazin.local
  ...

Fiecare host primește regula lui.

2pathType Exact

Greșit
YAML
path: /
pathType: Exact
Corect
YAML
path: /
pathType: Prefix

Exact potrivește doar calea exactă, nu și subpaginile.

3Lipsește ingressClassName

Greșit
YAML
spec:
  rules: ...
Corect
YAML
spec:
  ingressClassName: nginx
  rules: ...

Fără clasă, controllerul poate ignora Ingress-ul.

Repară tu

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

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: Prefix pentru site-uri cu subpagini.
  • Pune mereu ingressClassName.
  • Testează cu curl -H 'Host: ...' http://IP când DNS-ul nu e încă gata.
  • Verifică kubectl describe ingress după 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

← Toate erorile Kubernetes

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ță 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.