82 lines
3.7 KiB
Markdown
82 lines
3.7 KiB
Markdown
---
|
|
title: blog-topic / jdk-httpclient-dns-connectexception-classification
|
|
source_type: blog-topic
|
|
status: raw
|
|
related_branches: [feature-outbound-http-client-baseline]
|
|
related_projects: [ca-tmpl]
|
|
tags: [blog-topic, ca-tmpl, integration, networking, spring-boot, retry-policy, api-contract]
|
|
created: 2026-07-02
|
|
status_label: ready-for-canonical
|
|
target_audience: backend-engineer
|
|
inspiration_url:
|
|
archive_url:
|
|
---
|
|
|
|
# blog-topic: jdk-httpclient-dns-connectexception-classification
|
|
|
|
> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.
|
|
|
|
## Parent / 부모
|
|
|
|
- [[raw/branch-notes/feature-outbound-http-client-baseline]] — outbound HTTP failure taxonomy에서 DNS 실패 분류 edge case로 나온 글감.
|
|
|
|
## 트리거 / Trigger
|
|
|
|
- 트리거 유형: `branch-work`
|
|
- 트리거 날짜: 2026-07-02
|
|
- 트리거 연결 노트: [[raw/branch-notes/feature-outbound-http-client-baseline]]
|
|
|
|
## 글감 / Topic seed
|
|
|
|
- 한 문장 요지: JDK HttpClient에서 DNS 실패를 connection failure로 분류할 때 exception wrapping과 retry category를 어떻게 다뤘는지 정리한다.
|
|
- 예상 제목 후보:
|
|
- JDK HttpClient DNS 실패는 어떤 outbound failure일까
|
|
- DNS failure를 retryable connection error로 분류할 때 조심할 점
|
|
|
|
## 핵심 주장 후보 / Claim candidates
|
|
|
|
- 사실 후보:
|
|
- branch가 DNS 실패 분류 topic을 명시한다 — 근거 후보: [[raw/branch-notes/feature-outbound-http-client-baseline]] line `:373`.
|
|
- 경험 후보:
|
|
- DNS failure classification은 outbound failure taxonomy의 실제 edge case로 남아 있다.
|
|
- 의견/해석 후보:
|
|
- retry policy는 HTTP status만 보아서는 부족하고, connect/DNS/TLS/read timeout 같은 transport failure를 별도로 분류해야 한다.
|
|
|
|
## Outline seed
|
|
|
|
1. HTTP client failure는 HTTP status만이 아니다 — DNS, connect, TLS, read timeout을 transport layer로 분리한다.
|
|
2. JDK HttpClient exception wrapping 읽기 — root cause와 exposed exception이 다를 수 있다.
|
|
3. retry category로 연결하기 — connection failure와 remote 5xx를 같은 방식으로 다루지 않는다.
|
|
|
|
## Canonical 전환 후보 / Canonical extraction candidates
|
|
|
|
- `wiki/projects/ca-tmpl/outbound-http-client-baseline.md` 후보:
|
|
- ca-tmpl outbound HTTP failure classification 구현 사실.
|
|
- `wiki/concepts/outbound-http-failure-classification.md` 후보:
|
|
- outbound failure taxonomy 일반 개념.
|
|
- 필요한 추가 검증:
|
|
- JDK HttpClient DNS 실패 재현 테스트와 exception class chain.
|
|
|
|
## Sources / 근거 후보
|
|
|
|
- [[raw/branch-notes/feature-outbound-http-client-baseline]] — DNS classification topic seed 근거.
|
|
|
|
## 미해결 / Unknown
|
|
|
|
- 아직 확인해야 할 사실: DNS failure가 실제 코드에서 어떤 exception path로 들어오는지.
|
|
- 과장하면 안 되는 부분: 운영 장애 사례처럼 쓰지 않는다. local/test evidence 중심 글감으로 제한한다.
|
|
- 블로그로 쓰기 전에 필요한 canonical 정제: outbound HTTP project 문서의 failure taxonomy 갱신.
|
|
|
|
## Decision / 처리 결정
|
|
|
|
- 액션: `promote-to-canonical`
|
|
- 이유: `wiki/projects/ca-tmpl/data-layer-persistence-cache-outbound.md` 에 JDK HttpClient DNS/ConnectException classification 글감으로 반영했다.
|
|
- 다음 단계: target canonical이 아직 `draft` 이므로 `blogify` 전 review/verify가 필요하다. 운영 장애 사례처럼 쓰지 않는다.
|
|
|
|
## Related / 관련
|
|
|
|
- 관련 branch: [[raw/branch-notes/feature-outbound-http-client-baseline]]
|
|
- 관련 error:
|
|
- 관련 interview prep:
|
|
- derived blog: 생성 전. 생성 시 `wiki/blog/jdk-httpclient-dns-connectexception-classification-YYYY-MM-DD.md` 후보
|