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: archunit-empty-should-anchor-2026-05-27

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

Parent / 부모

raw/branch-notes/feature-skeleton-package-blueprint-contract — skeleton package/module blueprint 구현 중 빈 production anchor package가 ArchUnit rule의 empty check에 걸렸다.
raw/project-notes/ca-skeleton-operational-contract — ca-tmpl skeleton의 package/module boundary 검증 이슈다.

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

Rule 'no classes that reside in a package '..domain..' should depend on classes that reside in any package ...' failed to check any classes.

발생 컨텍스트: cd src && ./gradlew clean test 실행 중 CleanArchitectureTest의 domain_is_pure, application_does_not_depend_on_adapters_or_transport, persistence_adapter_does_not_depend_on_web_or_outbound_adapters, web_dtos_stay_in_web_adapter가 실패.
발생 시점: 2026-05-27
발생 환경: local ca-tmpl repository.
재현 가능 여부: always — production 샘플 도메인을 sample-ticket으로 격리하고 본체 모듈이 anchor/package-info 중심이 되면 재현.

production 모듈에서 reference domain/application/persistence DTO class를 제거하고 skeleton anchor만 남긴다.
cd src && ./gradlew clean test를 실행한다.
기대 결과: 빈 anchor module도 skeleton blueprint의 유효한 상태로 인정된다.
실제 결과: ArchUnit 기본 설정이 empty that() clause를 실패로 처리한다.

2026-05-27 — full test 실행 → CleanArchitectureTest 4개 rule 실패.
2026-05-27 — test result XML 확인 → 실제 dependency violation이 아니라 검사 대상 class가 없는 empty should 실패임을 확인.
2026-05-27 — 빈 skeleton package가 의도된 상태인 rule에만 allowEmptyShould(true) 적용.
2026-05-27 — full ./gradlew test 재실행 → 성공.

직접 원인: ArchUnit은 기본적으로 that() 조건에 매칭되는 class가 없으면 rule 실패로 처리한다.
근본 원인: skeleton template에서는 production domain/application/persistence/dto가 아직 비어 있을 수 있는데, 기존 ArchUnit rule은 "빈 anchor도 유효한 skeleton 상태"라는 전제를 표현하지 않았다.
트리거 조건: sample/reference 코드를 sample-ticket으로 격리하여 production 모듈의 일부 package가 빈 상태가 됨.

raw/branch-notes/feature-skeleton-package-blueprint-contract — 빈 anchor module과 ArchUnit guardrail을 함께 유지하기로 한 branch 결정.
wiki/projects/ca-tmpl/clean-architecture-package-layout — ca-tmpl에 실제 적용된 module/package layout canonical.

적용한 조치: 빈 상태가 skeleton contract상 유효한 rule에만 allowEmptyShould(true)를 붙였다.
검증 방법:
- cd src && ./gradlew test 성공.
- cd src && ./gradlew verifyCleanArchitectureDependencies 성공.
잔여 위험 / 후속 작업: 실제 production domain/application class가 생긴 뒤에도 동일 rule이 의존성 위반을 잡는지 red/green test로 보강할 필요가 있다.

빨리 감지하는 신호: ArchUnit failure message에 "failed to check any classes"가 나오면 dependency violation이 아니라 empty rule 문제일 가능성이 높다.
예방 체크리스트 항목 후보: skeleton anchor package를 허용하는 rule과 실제 production code가 있어야 하는 rule을 구분한다.
wiki로 끌어올릴 가치가 있는 일반화된 교훈: template repository에서는 "아직 비어 있음"이 실패가 아니라 의도된 중간 상태일 수 있으므로 architecture test가 그 상태를 명시해야 한다.