DongHyeonka 88ed45b734 build(deps): guava를 33.7.2로 고정한다
문제: guava의 HIGH CVE-2026-102554(역직렬화 중 메모리 할당 제한 없음)는
33.7.2에서 고쳤다. 그런데 guava는 어떤 leaf도 직접 선언하지 않고, 낡은 버전이
셋에서 들어온다.
- gRPC 1.75.0: 33.3.1-android(lockfile에는 jre 변형 이름으로도 남는다)
- Error Prone 2.49.0(annotationProcessor 구성): 33.5.0-jre
- Checkstyle 13.5.0(checkstyle 구성): 33.6.0-jre
leaf 거의 전부의 lockfile에 걸린다.

고친 방법: 카탈로그에 `pinned-*` 라이브러리 묶음을 두고, JavaConventionsPlugin이
그 묶음을 Spring dependency management로 모든 leaf에 건다. 첫 항목이
`pinned-guava`(33.7.2-jre)다. 버전 키 주석에 CVE와 낡은 버전을 가져오는 곳을
적고, 그곳들이 고친 버전을 가져오면 지운다.
- dependency management를 쓰는 이유: Boot BOM처럼 모든 구성에 걸린다.
  checkstyle·annotationProcessor 구성도 받는다(lockfile에서 checkstyle 구성의
  commons-lang3가 BOM override 3.20.0인 것이 이미 그 증거다). Gradle constraint는
  구성마다 따로 걸어야 한다.
- 버전을 카탈로그에 두는 이유: 이 빌드가 고르는 버전이다(카탈로그 머리말).
  BOM이 관리하는 것을 덮는 override와 다르다.
- build-logic `PlatformModuleConventionTest`에 시험을 하나 더했다. fixture
  카탈로그의 `pinned-fixture`는 checkstyle 구성의 관리 버전이 되고,
  `unpinned-fixture`는 관리되지 않는다.
- 버린 대안: Error Prone 2.51.0, Checkstyle 14.4.0으로 올리기. 둘 다 guava
  33.7.2를 가져오지만 gRPC 쪽은 남고, 새 검사 규칙이 들어와 범위가 커진다.
  Checkstyle 14는 메이저다.

위험·한계: dependency management는 하한이 아니라 정확한 고정이다. 나중에
33.7.2보다 새 guava를 요구하는 라이브러리가 들어와도 33.7.2로 내린다. 그때는
그 leaf가 guava를 버전과 함께 직접 선언하면 그 선언이 이긴다. gRPC가 쓰던
android 변형 대신 jre 변형이 들어간다. jre 변형은 android 변형의 API를 모두
가진다. guava 33.7.2가 요구하는 대로 error_prone_annotations 2.50.0,
failureaccess 1.0.3, j2objc-annotations 3.1, jspecify 1.0.1이 같이 들어오고
checker-qual은 빠진다.

같은 커밋의 작은 정리: 앞 커밋이 넣은 httpcore5 주석의 줄바꿈을 고쳤다.

검증(desktop, 트리 49191720 위에 시험·주석 정리를 얹은 9a97dbbb):
- 세 빌드를 `--write-locks`로 다시 썼다. lockfile 64개에서 guava가 33.7.2-jre
  하나가 됐다(checkstyle·annotationProcessor 구성 포함). 위 동반 라이브러리 외에
  바뀐 것은 없고, 새로 생기거나 사라진 구성 0.
- RED: 장치 없는 트리(앞 커밋)에 새 시험만 얹으면 실패한다
  ("pinned=null unpinned=null").
- GREEN: `./gradlew -p build-logic check javadoc` rc=0, 테스트 174 실패 0.
- `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` rc=0, 6분 33초,
  태스크 752(executed 641, up-to-date 111, from cache 0). 모든 leaf가 새 guava로
  Error Prone·Checkstyle을 돌렸다.
- `./gradlew -p platforms/optional-build ci verifyDependencyLocks` rc=0, 1분 11초.
2026-11-07 17:36:22 +09:00
S
Description
clean-architecture-backend-template에서 빼낸 messaging-library (design-docs repo-structure/05-library-repos.md)
1.6 MiB
Languages
Java 98.9%
Shell 0.9%
Python 0.2%