...
Eroare AWS · Load balancer (ALB) și Auto Scaling

Target.ResponseCodeMismatch: Health checks failed with these codes: [404]

Pe scurt

Load balancer-ul verifică sănătatea serverelor cerând o anumită cale (HealthCheckPath), iar serverele răspund 404, deci sunt marcate unhealthy. Pune în target group o cale pe care serverul chiar o servește (de exemplu /) sau creează pagina cerută, apoi așteaptă ca țintele să devină healthy.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un target group trimite periodic o cerere HTTP la fiecare țintă, pe calea HealthCheckPath (implicit /), și așteaptă un cod din Matcher (implicit 200). Dacă primește alt cod de mai multe ori la rând, ținta devine unhealthy, iar load balancer-ul nu-i mai trimite trafic. Când toate țintele sunt nesănătoase, vizitatorii primesc 503.

aws elbv2 describe-target-health arată pentru fiecare țintă State, Reason și Description. Target.ResponseCodeMismatch cu [404] înseamnă că serverul răspunde, dar pagina de health check nu există. Codul dintre paranteze îți spune ce a primit: [404] = calea lipsește, [301] / [302] = redirecționare (de exemplu spre HTTPS), [500] = aplicația are o eroare.

Dacă motivul e Target.Timeout, problema e de rețea (security group, port), nu de cale.

De ce apare: cauzele frecvente

1Calea de health check nu există pe server

Greșit
BASH
aws elbv2 create-target-group --name web-tg --protocol HTTP --port 80 \
  --vpc-id $VPC --health-check-path /health
# nginx servește doar index.html
Corect
BASH
aws elbv2 modify-target-group --target-group-arn $TG --health-check-path /

/ există pe server (pagina principală) și răspunde 200.

2Pagina de health check nu a fost creată

Greșit
BASH
# user data:
echo "<h1>Magazin</h1>" > /usr/share/nginx/html/index.html
Corect
BASH
# user data:
echo "<h1>Magazin</h1>" > /usr/share/nginx/html/index.html
echo ok > /usr/share/nginx/html/health

Dacă vrei o cale separată, /health, serverul trebuie să o servească.

3Redirecționare spre HTTPS sau login

Greșit
BASH
# health check pe / primește 301 spre https://
# Description: Health checks failed with these codes: [301]
Corect
BASH
aws elbv2 modify-target-group --target-group-arn $TG \
  --health-check-path /health --matcher HttpCode=200

Pune health check-ul pe o cale care răspunde direct 200, fără redirecționare, sau acceptă și codul primit în Matcher.

Repară tu

Repară eroarea, direct în pagină

Serverele magazinului din web-asg rulează nginx și servesc doar pagina principală. Target group-ul web-tg face health check pe /health, iar describe-target-health arată Health checks failed with these codes: [404], deci site-ul prin web-alb dă 503. Repară health check-ul ca să verifice pagina principală (/) și așteaptă ca ambele servere să devină sănătoase.

Indiciu

aws elbv2 modify-target-group --target-group-arn $TG --health-check-path /, apoi aws elbv2 wait target-in-service --target-group-arn $TG.

Alte forme ale mesajului

  • Target.ResponseCodeMismatch: Health checks failed with these codes: [301]
  • Target.ResponseCodeMismatch: Health checks failed with these codes: [502]
  • Target.Timeout: Request timed out
  • "State": "unhealthy", "Reason": "Target.ResponseCodeMismatch"

Cum o eviți pe viitor

  • Alege calea de health check odată cu aplicația și creeaz-o (de obicei /health, care răspunde rapid 200).
  • Testează calea direct pe server înainte: curl -i http://<IP>/health.
  • După orice schimbare, urmărește aws elbv2 describe-target-health până țintele devin healthy.
  • La Auto Scaling cu --health-check-type ELB, o cale greșită face ca serverele să fie înlocuite la nesfârșit; verifică-o întâi.

Întrebări frecvente

Cât durează până o țintă devine healthy?

Implicit, health check-ul rulează la 30 de secunde și cere 5 răspunsuri bune la rând, deci 2–3 minute. Poți micșora intervalul și pragul cu modify-target-group.

Serverul merge când îl accesez direct. De ce e unhealthy?

Pentru că load balancer-ul cere altă cale decât cea pe care o încerci tu. Rulează curl -i exact pe calea și portul din describe-target-groups (HealthCheckPath, HealthCheckPort).

Erori înrudite

← Toate erorile AWS

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ță AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.