문제(리뷰 README 19.4절 끝 개선 제안):
- web README는 필터가 던진 예외가 GlobalExceptionHandler를 지나지
않는다고만 적는다. 그 예외의 서버 로그가 어디서 어떤 모양으로
남는지(ServerFailureLog의 정리를 받지 못한다는 것)는 적혀 있지 않고,
리뷰도 실행으로 확인하지 않았다.
고른 방법:
- 먼저 실제 Tomcat 테스트 FilterFailureContainerLogIT(systemTest)로
확인했다. 필터가 PersistenceFailureException(SQL 원인)을 감싼 예외를
던지면 WARN 이상 줄은 하나뿐이다: Tomcat ContainerBase…
[dispatcherServlet] logger의 ERROR "Servlet.service() for servlet
[dispatcherServlet] … threw exception"과 원인 사슬 전체(SQL 접속
문자열 포함). GlobalExceptionHandler 줄은 없다.
- 그 결과를 README 「EnvelopeErrorController」 절에 적고, 필터에서
저장소·외부 의존을 부르면 실패를 필터에서 잡아 EnvelopeResponseWriter로
답하고 로그는 ServerFailureLog.of로 정하라고 안내한다. 테스트는 그
문장을 지키려고 남긴다.
위험·한계:
- Tomcat에서만 확인했다. Jetty는 확인하지 않았다고 README에 적었다.
- 로그 줄 모양은 Tomcat 버전에 기댄다. 바뀌면 이 테스트가 실패한다.
검증(desktop, flock, --no-build-cache, 로그 ~/r9-g1-inbound-logs/):
- 확인(README를 쓰기 전, 기준 3eb3b067 + 이 테스트, 트리 a675c244):
:adapter:inbound:web:systemTest --tests FilterFailureContainerLogIT rc=0.
로그: "ERROR … o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service()
for servlet [dispatcherServlet] in context with path [] threw exception"과
"Caused by: java.sql.SQLException: jdbc:postgresql://db.internal/…".
red/R4-web-filter-log.log
- 이 커밋 트리(64089130, 브랜치 마지막 트리)의 pull request 단계 게이트
(모두 rc=0, FROM-CACHE 0, green2/; 같은 worktree 앞 실행의 UP-TO-DATE는
green/의 같은 이름 로그가 트리 d6f6b28a에서 실행한 것):
- :ci :verifyDependencyLocks --warning-mode=fail — 태스크 1142, test
XML 2,216건 실패 0(skip 19 이전부터). 전체 실행은 green/D01-ci.log
(752초), 그 뒤 바뀐 web·websocket test는 green2/B1에서 실행.
- :verifyStrictLaneStages --dry-run, :sample-portfolio:check
:sample-portfolio:qualityCheck, -p optional-platforms ci,
-p optional-platforms :verifyStrictLaneStages --dry-run,
bash scripts/verify-compose-profile-contracts.sh(18 lane 일치)
- 바뀐 경로로 켜지는 pr-adapters lane: web systemTest 19건·
webJettyCompatTest 16건, websocketJettyTest 8건, websocketNginxTest
4건, jpaPlatformContractTest PostgreSQL 16·18 각 429건,
jpaPlatformMigrationTest 45건, 모두 실패 0
- 링크 검사(lychee 없음)는 check-work-docs.py --links로 대체: 555개 깨짐
0. check-work-docs.py rc=0
- 해당 없음·못 돌림: grpc-proto-buf(.proto 변경 없음),
dependency-review(lockfile 변경 없음), trivy-fs(desktop에 trivy 없음)
- 더 돌린 것: graphql·websocket systemTest 55건, documentContractTest 67건,
바뀐 leaf 여섯의 testQualityCheck rc=0
Refs: docs/reviews/2026-11-03-rereview/README.md 19.4절 끝(개선 제안), 19.5절