동일 코드, 이미지인데 서버 한 대만 400을 반환한다 — 원인 특정하기
상황 — 같은 서비스를 서버 3대로 돌리고 있는데, 두 대는 정상인데 한 대만 400(Bad Request) 을 반환합니다. 코드도, 배포한 도커 이미지도 세 대가 같다고 합니다. 로그엔 "유효하지 않은 파라미터", IllegalArgumentException, Integer 같은 단서가 보입니다. 코드가 같은데 왜 한 대만 다르게 동작할까요? 이 질문의 범위를 어떻게 좁혀 가는지 정리합니다.
먼저 400이 무슨 뜻인가
400 Bad Request는 "요청이 잘못됐다" — 서버 코드의 버그라기보다 들어온 요청(파라미터, 본문, 타입)이 서버가 받을 수 있는 형태가 아니다라는 신호입니다. (HTTP 메서드가 틀리면 400이 아니라 405 Method Not Allowed라, 400은 대개 값, 형식 문제)
스프링 MVC에서 흔한 400 하나는 경로 변수(PathVariable) 타입 불일치입니다.
WARN o.s.w.s.m.s.DefaultHandlerExceptionResolver :
Resolved [MethodArgumentTypeMismatchException:
Failed to convert value of type 'String' to required type 'Integer';
nested exception is java.lang.NumberFormatException: For input string: "..."]
@GetMapping("/tracks/{trackId}")
public TrackResponse get(@PathVariable Integer trackId) { ... } // trackId가 정수로 변환 안 되면 400
즉 이 400은 "그 요청의 trackId 값이 정수로 바꿀 수 없는 값"이라는 뜻입니다. 그런데 코드는 세 대가 같으니, 같은 요청이면 세 대 다 같은 400이 발생해야 정상입니다.
핵심 질문 — 같은 코드인데 왜 한 대만?
SVG 코드
<svg xmlns="http://www.w3.org/2000/svg" width="440" height="126" viewBox="0 0 440 126" font-family="-apple-system, 'Segoe UI', 'Noto Sans KR', sans-serif">
<defs><marker id="ah" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#888"/></marker></defs>
<rect x="0" y="0" width="440" height="126" fill="#FFFFFF"/>
<g transform="translate(0,-24)">
<rect x="160" y="40" width="120" height="32" rx="6" fill="#F7F7F7" stroke="#999999"/>
<text x="220.0" y="60.0" font-size="12" fill="#333" text-anchor="middle" font-weight="bold">로드밸런서</text>
<rect x="15.0" y="104" width="125" height="32" rx="6" fill="#E9F2E9" stroke="#8FBF8F"/>
<text x="77.5" y="124.0" font-size="12" fill="#2E6B2E" text-anchor="middle" font-weight="bold">인스턴스 1: 정상</text>
<line x1="220" y1="72" x2="77.5" y2="102" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<rect x="157.5" y="104" width="125" height="32" rx="6" fill="#E9F2E9" stroke="#8FBF8F"/>
<text x="220.0" y="124.0" font-size="12" fill="#2E6B2E" text-anchor="middle" font-weight="bold">인스턴스 2: 정상</text>
<line x1="220" y1="72" x2="220.0" y2="102" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<rect x="300.0" y="104" width="125" height="32" rx="6" fill="#FCE4EC" stroke="#D06A86"/>
<text x="362.5" y="124.0" font-size="12" fill="#9E3A57" text-anchor="middle" font-weight="bold">인스턴스 3: 400</text>
<line x1="220" y1="72" x2="362.5" y2="102" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
</g>
</svg>
같은 코드로 입력이 같으면 결과도 같아야 합니다. 한 대만 다르다면, 셋 중 하나가 실제로는 같지 않다는 뜻입니다 — 무엇이 다른지부터 찾아야 합니다.
무엇이 다를 수 있나 (의심할 곳)
"특정 한 대만" 문제의 원인은 대개 코드가 아니라 빌드가 실제로 다르거나, 그 서버가 받는 요청이 실제로 다른 것입니다. 특히 "요청이 다르다"에는 몇 가지 경로가 있습니다.
① 배포가 사실은 다르다 (가장 흔함)
롤링 배포 중 한 대만 구버전이 남았거나, 태그는 같은데 실제 이미지 다이제스트가 다른 경우입니다. 태그(:latest, :2026.08)는 같아도 내용은 다를 수 있으니, 다이제스트로 확인합니다.
# 파드별 실제 이미지 다이제스트 비교 — 한 대만 다르면 배포 불일치
kubectl get pods -l app=track \
-o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.containerStatuses[0].imageID}{"\n"}{end}'
# track-1 ...@sha256:aaaa ← 신버전
# track-2 ...@sha256:aaaa
# track-3 ...@sha256:bbbb ← 이 한 대만 구버전
/actuator/info의 git 커밋 해시를 세 대에서 비교해도 같은 걸 확인할 수 있습니다.
② 클라이언트가 보낸 값이 다르다
서버가 이상한 게 아니라 그 서버로 라우팅된 요청만 이상한 경우입니다. 스티키 세션이나 특정 클라이언트(구버전 애플리케이션 등)가 그 한 대로 몰려, 정수가 아닌 trackId를 보내고 있을 수 있습니다.
SVG 코드
<svg xmlns="http://www.w3.org/2000/svg" width="440" height="226" viewBox="0 0 440 226" font-family="-apple-system, 'Segoe UI', 'Noto Sans KR', sans-serif">
<defs><marker id="ah" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#888"/></marker></defs>
<rect x="0" y="0" width="440" height="226" fill="#FFFFFF"/>
<g transform="translate(0,-24)">
<rect x="20" y="40" width="170" height="46" rx="6" fill="#EEF3FB" stroke="#4C7FE0"/>
<text x="105.0" y="60.0" font-size="12" fill="#26508F" text-anchor="middle" font-weight="bold">정상 클라이언트</text>
<text x="105.0" y="76.0" font-size="10.5" fill="#555" text-anchor="middle">/tracks/123</text>
<rect x="250" y="40" width="170" height="46" rx="6" fill="#FCE4EC" stroke="#D06A86"/>
<text x="335.0" y="60.0" font-size="12" fill="#9E3A57" text-anchor="middle" font-weight="bold">구버전 애플리케이션</text>
<text x="335.0" y="76.0" font-size="10.5" fill="#555" text-anchor="middle">/tracks/undefined</text>
<rect x="160" y="130" width="120" height="32" rx="6" fill="#F7F7F7" stroke="#999999"/>
<text x="220.0" y="150.0" font-size="12" fill="#333" text-anchor="middle" font-weight="bold">로드밸런서</text>
<line x1="105" y1="86" x2="190" y2="128" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<line x1="335" y1="86" x2="250" y2="128" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<text x="300" y="116" font-size="10.5" fill="#333" text-anchor="start">스티키 라우팅</text>
<rect x="20" y="205" width="170" height="32" rx="6" fill="#E9F2E9" stroke="#8FBF8F"/>
<text x="105.0" y="225.0" font-size="12" fill="#2E6B2E" text-anchor="middle" font-weight="bold">인스턴스 1, 2: 정상</text>
<rect x="250" y="205" width="170" height="32" rx="6" fill="#FCE4EC" stroke="#D06A86"/>
<text x="335.0" y="225.0" font-size="12" fill="#9E3A57" text-anchor="middle" font-weight="bold">인스턴스 3: 400</text>
<line x1="190" y1="162" x2="105" y2="203" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<line x1="250" y1="162" x2="335" y2="203" stroke="#888" stroke-width="1.2" marker-end="url(#ah)"/>
<text x="300" y="186" font-size="10.5" fill="#333" text-anchor="start">BAD 요청이 이쪽으로</text>
</g>
</svg>
그 한 대의 접근 로그를 보면 요청 값이 나타납니다.
# 인스턴스 3 접근 로그 — 정수 자리에 문자열이 들어옴
GET /tracks/undefined → 400
GET /tracks/ → 400 (빈 값)
③ 앞단이 요청을 변경한다
클라이언트는 정상 값을 보냈는데, 그 서버 앞의 프록시와 게이트웨이가 경로를 다르게 변경하는 경우입니다. 그 한 대 앞단만 경로 변환 규칙이 다르면, 같은 요청이 그 서버에는 비정상 trackId로 도착해 400이 됩니다.
④ 그 노드만 인코딩 설정이 다르다
URL에 인코딩된 문자가 있을 때, 그 노드만 URL 인코딩 설정(예: server.tomcat.uri-encoding)이 다르면 같은 URL이 그 서버에서만 숫자가 아닌 값으로 해석될 수 있습니다. 역시 같은 요청인데 그 한 대만 400이 됩니다.
정수 변환은 같은 값이면 어느 서버에서나 결과가 같습니다. 그래서 "같은 요청인데 한 대만 400"이라면, 결국 빌드(①)나 그 서버가 받는 요청(②, ③, ④) 중 하나가 다른 것입니다.
어떻게 범위를 좁히나 (거꾸로 질문하기)
원인을 특정할 때 핵심은 "코드의 어느 줄"을 먼저 찾는 게 아니라, 차이를 좁혀 가는 질문입니다.
- 정말 같은 빌드인가 — 세 대의 이미지 다이제스트, 커밋 해시,
/actuator/info버전을 직접 비교. "태그가 같다"가 아니라 다이제스트로 확인. - 그 400 요청이 실제로 무엇인가 — 접근 로그에서 그 한 대에 온 400 요청의 실제 URL,
trackId값을 본다. 값이 비정상이면 원인은 서버가 아니라 요청(②). - 그 인스턴스만 오는 요청인가 — 같은(정상) 요청을 세 대에 직접 보내 본다. 셋 다 정상이면 "그 서버 문제"가 아니라 "그 서버로 온 요청 문제".
- 앞단과 인코딩을 비교 — 그 인스턴스 앞의 프록시와 게이트웨이가 경로를 변경하는지, URL 인코딩 설정이 다른지 나란히 비교.
즉 "코드 어디가 문제인지"보다 "세 대 중 무엇이 다른지(빌드, 요청)"를 먼저 비교하는 게 지름길입니다. 스택트레이스는 그 첫 힌트이고(여기선 Integer 변환 실패 → trackId), 로그는 항상 가장 많은 단서를 제공합니다.
정리
400은 대개 요청(파라미터, 타입) 문제로, 여기선PathVariable의 정수 변환이 실패한 경우입니다.- 코드가 같은데 한 대만 다르면, 두 가지 중 하나가 실제로 다른 것이니 빌드(배포) 불일치, 또는 요청 차이(클라이언트가 비정상 값을 보냈거나와 앞단에서 변형됐거나)를 의심합니다.
- 점검은 이미지 다이제스트/버전 비교 → 그 요청의 실제 값 확인 → 세 대에 같은 요청 재현 → 앞단, 인코딩 diff 순으로 합니다.
- "특정 인스턴스만"은 코드보다 "무엇이 다른가"를 비교하는 문제입니다.
지표와 로그로 범위를 좁혀 가는 일반 원칙은 서버 지표 읽기도 함께 보세요.
용어 한 줄 정리
| 용어 | 쉬운 뜻 |
|---|---|
| 400 Bad Request | 요청 자체가 잘못됨(값, 형식, 타입) |
| PathVariable | URL 경로에 포함된 값(예: /tracks/{trackId}) |
| MethodArgumentTypeMismatchException | 파라미터를 요구 타입으로 못 바꿀 때 발생하는 스프링 예외(→400) |
| 이미지 다이제스트 | 태그와 별개로 이미지 내용을 식별하는 해시 |
| 롤링 배포 | 인스턴스를 차례로 교체하는 배포(일부만 남을 수 있음) |
