From 44779a06255a73adbe0a408042969db4ba6c9cc4 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:27:30 +0900 Subject: [PATCH] =?UTF-8?q?docs(web):=20web=20README=EC=9D=98=20=EC=97=86?= =?UTF-8?q?=EB=8A=94=20=EC=98=A4=EB=A5=98=20=EC=BD=94=EB=93=9C=EC=99=80=20?= =?UTF-8?q?=EC=A7=80=EC=9A=B4=20IP=20=EB=AA=A8=EB=93=9C=20=EC=A3=BC?= =?UTF-8?q?=EC=9E=A5=EC=9D=84=20=EC=BD=94=EB=93=9C=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 번역 묶음(D2b)이 확인하지 못하고 넘긴 대문자 식별자 넷을 코드와 대조했다. MAX_CONCURRENT_STREAMS(RFC 9113 HTTP/2 설정 이름)와 DEFAULT_MAX_PAGE_SIZE (Spring Data 상수)는 바깥 이름이라 맞다. 둘은 틀렸다. - 예외 대응 표의 MaxUploadSizeExceededException 행이 「multipart 전용 413(UPLOAD_SIZE_EXCEEDED)은 이 영역의 책임 — 병합 후 정제」라고 적는다. 그런 오류 코드는 레지스트리에도 코드에도 없다. GlobalExceptionHandler.handleMaxUploadSizeExceededException은 multipart와 JSON 본문 모두 PAYLOAD_TOO_LARGE(413)로 답한다. 그대로 적었다. - 「클라이언트 IP」 절이 지운 모드의 이름(FORWARDED_HEADERS_TRUSTED)을 지금 있는 것처럼 인라인 코드로 적는다. 이름을 빼고, 지운 사실은 제거 표 (docs/capability-status.md 「제거된 코드」)를 가리킨다. 검증(노트북): check-docs.py OK. 이 README를 읽는 테스트는 없다 (git grep 'inbound/web/README'). --- src/adapter/inbound/web/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/adapter/inbound/web/README.md b/src/adapter/inbound/web/README.md index a2d2830e..840517b1 100644 --- a/src/adapter/inbound/web/README.md +++ b/src/adapter/inbound/web/README.md @@ -261,7 +261,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML | `DependencyFailureException` | `ex.errorCode()` (사전분류 `DEPENDENCY_*`) | 코드 결정 | adapter-outbound `OutboundHttpErrorMapper` 가 upstream 실패를 분류. 클라이언트 메시지는 category 문구, **절대 `ex.getMessage()` 아님**. retryable + `retry_after_seconds` 있으면 `RetryAfterAdvisor` 로 `Retry-After` 부착 | | `HttpRequestMethodNotSupportedException` | `METHOD_NOT_ALLOWED` | 405 | D12: 405 는 지원 메서드를 나열한 `Allow` 헤더 필수 | | `HttpMediaTypeNotSupportedException` | `UNSUPPORTED_MEDIA_TYPE` | 415 | D9: 요청 본문 형식 미지원 — 406 과 구별 | -| `MaxUploadSizeExceededException` | `PAYLOAD_TOO_LARGE` | 413 | D8: 과대 본문은 envelope 내 413, raw 500 금지. 멀티파트 전용 413(`UPLOAD_SIZE_EXCEEDED`)은 이 영역의 책임 — 병합 후 정제 | +| `MaxUploadSizeExceededException` | `PAYLOAD_TOO_LARGE` | 413 | D8: 과대 본문은 envelope 내 413, raw 500 금지. multipart와 JSON 본문 모두 이 코드다(multipart 전용 코드는 없다) | | `HttpMediaTypeNotAcceptableException` | `NOT_ACCEPTABLE` | 406 | D9: Accept 에 맞는 표현 없음 — 415 와 구별(합치면 RFC 9110 의미론 상실) | | `MethodArgumentNotValidException` | `VALIDATION_FAILED` | 코드 상태 | 정규화된 field + allowlisted reason code/fixed message 리스트를 details 로. rejectedValue/defaultMessage/iterable key/index는 secret/PII 가능성이 있어 미노출 | | `HttpMessageNotReadableException` | `VALIDATION_FAILED` | 코드 상태 | cause 클래스명을 details 로 | @@ -399,8 +399,8 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML filter 는 handler mapping 이전에 실행돼 구체 경로만 보므로 모든 id 가 서로 다른 키가 되어버린다. ### 클라이언트 IP -- 비인증 키의 IP 는 `getRemoteAddr()` 하나다. 헤더를 직접 읽는 모드(`FORWARDED_HEADERS_TRUSTED`)는 - XFF 맨 왼쪽 값(호출자가 쓰는 값)을 키로 써서 삭제했다. +- 비인증 키의 IP 는 `getRemoteAddr()` 하나다. 헤더를 직접 읽는 모드는 없다. XFF 맨 왼쪽 값(호출자가 쓰는 값)을 + 키로 써서 지웠다(`docs/capability-status.md` 「제거된 코드」). - 프록시 뒤에서는 `server.forward-headers-strategy=native` + `server.tomcat.remoteip.internal-proxies` 로 Tomcat 이 신뢰 프록시에게서 온 XFF 만 반영한다. `framework` 는 모든 peer 를 믿으므로 `RateLimitWebConfig` 가 기동을 거부한다.