Files

T

2026-07-25 12:53:13 +09:00

title, source_type, status, related_branches, related_projects, tags, created, status_label

title

source_type

status

related_branches

related_projects

error: sample-ticket-oauth2-resource-server-dependency-2026-05-27

Layer: raw/errors/ — 작업 중 마주친 단일 실패·트러블슈팅 기록. 원본은 raw에 영구 보관한다.

Parent / 부모

raw/branch-notes/feature-skeleton-package-blueprint-contract — reference code를 production module에서 sample-ticket으로 격리하는 중 sample module compile classpath가 부족했다.
raw/project-notes/ca-skeleton-operational-contract — ca-tmpl sample fixture 격리 정책과 연결된다.

에러 메시지 (원문 그대로):

package org.springframework.security.oauth2.server.resource does not exist
cannot find symbol: class InvalidBearerTokenException

발생 컨텍스트: cd src && ./gradlew test 실행 중 :sample-ticket:compileJava 실패.
발생 시점: 2026-05-27
발생 환경: local ca-tmpl repository.
재현 가능 여부: always — sample-ticket 내부 GlobalExceptionHandler가 InvalidBearerTokenException을 import하지만 sample module에 resource-server starter가 없으면 재현.

2026-05-27 — full test 재실행 → :sample-ticket:compileJava 실패.
2026-05-27 — GlobalExceptionHandler import 확인 → InvalidBearerTokenException이 resource-server starter에서 제공되는 type임을 확인.
2026-05-27 — sample-ticket/build.gradle에 spring-boot-starter-oauth2-resource-server 추가.
2026-05-27 — full ./gradlew test 재실행 → 성공.

직접 원인: sample-ticket의 compile classpath에 spring-boot-starter-oauth2-resource-server가 없었다.
근본 원인: 기존 production adapter-web module이 갖고 있던 external dependency를 sample module 이동 후에도 명시해야 했는데, project dependency만으로 external implementation dependency가 전파된다고 잘못 기대할 수 있었다.
트리거 조건: sample code를 별도 Gradle module로 격리하면서 compile dependency를 module-local로 재선언하지 않음.

raw/branch-notes/feature-skeleton-package-blueprint-contract — sample-ticket을 production과 분리된 fixture/sample consumer로 둔 결정.
wiki/projects/ca-tmpl/clean-architecture-package-layout — sample-ticket 격리 적용 사실.

적용한 조치: sample-ticket/build.gradle에 org.springframework.boot:spring-boot-starter-oauth2-resource-server를 추가했다.
검증 방법:
- cd src && ./gradlew test 성공.
- cd src && ./gradlew verifyCleanArchitectureDependencies 성공.
잔여 위험 / 후속 작업: sample-ticket이 production runtime classpath에 들어가지 않도록 Gradle dependency rule과 ArchUnit sample 역의존 금지를 계속 유지해야 한다.

빨리 감지하는 신호: sample module로 이동한 Spring component가 기존 module의 external starter type을 import하면 sample module에도 명시 dependency가 필요하다.
예방 체크리스트 항목 후보: production code를 sample module로 격리할 때 project dependency와 external dependency를 분리해서 점검한다.
wiki로 끌어올릴 가치가 있는 일반화된 교훈: sample/fixture module도 "실행되지 않는 코드"가 아니라 독립 compile 대상이므로 dependency contract가 필요하다.