llm-wiki/raw/official-docs/spring-framework-test-enabledif-jupiter-annotation.md

---
title: "Spring Framework — @EnabledIf / @DisabledIf JUnit Jupiter Annotations"
source_type: official-doc
url: https://docs.spring.io/spring-framework/reference/testing/annotations/integration-junit-jupiter.html
archive_url:
related_branches: [feature-contract-verification-test-suite]
related_projects: [ca-skeleton]
tags: [official-doc, ca-skeleton, testing, spring-framework, api-contract]
created: 2026-06-15
---

# Spring Framework — @EnabledIf / @DisabledIf JUnit Jupiter Annotations

> Layer: `raw/` — Spring Framework 공식 참조 문서의 JUnit Jupiter 통합 어노테이션 (`@EnabledIf` / `@DisabledIf`) 원문 발췌·출처 기록.
> 검증된 요약은 `/ingest` 후 `wiki/concepts/` 에 `source-summary-template` 형식으로 별도 작성.

## Parent / 활용 branch (필수)

| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| [[raw/branch-notes/feature-contract-verification-test-suite]] | D3: optional adapter contract test 는 adapter enabled env matrix 에서만 실행 (skipped, not failed) — `@EnabledIf` 가 Spring Environment 의 property placeholder (`${adapter.enabled}` 등) 를 읽어 `true` 일 때만 테스트를 실행(SKIPPED 처리)함을 공식 문서가 직접 명시 |

## 출처 / Source

- 원본 URL: https://docs.spring.io/spring-framework/reference/testing/annotations/integration-junit-jupiter.html
- 아카이브 URL: (미수집)
- 저자 / 조직: Spring Framework 공식 (VMware / Broadcom)
- 발행일: 불명 (Spring Framework 공식 참조 문서 — 버전 추적형)
- 마지막 확인일: 2026-06-15

## 왜 저장했는지 / Why archived

`feature-contract-verification-test-suite` branch 의 D3 결정("optional adapter contract test 는 adapter enabled env matrix 에서만 실행")을 뒷받침하는 공식 근거. Spring TestContext Framework 의 `@EnabledIf` 가 SpEL 또는 property placeholder 표현식을 평가해 `Boolean.TRUE` 또는 문자열 `"true"`(대소문자 무시)일 때만 테스트를 실행하고, 그렇지 않으면 JUnit Jupiter 의 SKIPPED 결과를 반환한다는 것을 공식 문서가 직접 명시한다.

## 핵심 인용 / Key quotes (verbatim, 3~5문장)

> [§@EnabledIf / Purpose] "Signals that an annotated JUnit Jupiter test class or test method is enabled and should be run if the supplied `expression` evaluates to `true`."

> [§@EnabledIf / Evaluation Rules] "Test is enabled if expression evaluates to `Boolean.TRUE` or a `String` equal to `true` (ignoring case)"

> [§@EnabledIf / Supported Expression Types — Property Placeholder] "**Property Placeholder** (from Spring Environment) `@EnabledIf("${smoke.tests.enabled}")`"

> [§@EnabledIf / Meta-Annotation Example] "`expression = \"#{systemProperties['os.name'].toLowerCase().contains('mac')}\",` `reason = \"Enabled on Mac OS\"`"

> [§@EnabledIf / Important Note] "Since JUnit 5.7, JUnit Jupiter has its own `@EnabledIf` annotation. Ensure you import from the correct package when using Spring's version."

## Claims Extracted / 추출된 주장

> 이 자료가 **직접 말하는 것만** claim 으로 분리한다.

| Claim ID | Claim (이 자료가 직접 말하는 것) | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| SPRING-ENABLEDIF-C1 | `@EnabledIf` 는 표현식이 `Boolean.TRUE` 또는 대소문자 무관 문자열 `"true"` 로 평가될 때만 해당 JUnit Jupiter 테스트를 실행한다 | [§Evaluation Rules] "Test is enabled if expression evaluates to `Boolean.TRUE` or a `String` equal to `true` (ignoring case)" | `official-vendor-doc` | Spring TestContext Framework + JUnit Jupiter 조합을 사용하는 모든 Spring 통합 테스트 | 표현식이 `false` 일 때 JUnit 이 `SKIPPED` 를 반환한다는 것을 명시적으로 서술하지는 않음 (JUnit Jupiter 조건부 실행 메커니즘에 따른 암묵적 결과) |
| SPRING-ENABLEDIF-C2 | `@EnabledIf` 의 표현식에는 SpEL(Spring Expression Language) 또는 Spring `Environment` 의 property placeholder 를 사용할 수 있다 | [§Supported Expression Types] "**Property Placeholder** (from Spring Environment) `@EnabledIf("${smoke.tests.enabled}")`" | `official-vendor-doc` | Spring `Environment` 에 등록된 모든 property (application.properties, 시스템 환경변수, 프로파일 등) | 특정 property 소스 우선순위(예: 시스템 환경변수 vs `application.properties`)를 이 페이지에서 정의하지는 않음 |
| SPRING-ENABLEDIF-C3 | `@EnabledIf` 는 `expression`, `reason` 속성을 가지며, `reason` 은 테스트가 비활성화될 때 보고되는 이유를 담는다 | [§Meta-Annotation Example] "`expression = \"#{systemProperties['os.name'].toLowerCase().contains('mac')}\",` `reason = \"Enabled on Mac OS\"`" | `official-vendor-doc` | Spring `@EnabledIf` 어노테이션 자체 | `loadContext` 속성의 동작(ApplicationContext 조기 로딩 여부)은 이 인용에서 확인되지 않음 |
| SPRING-ENABLEDIF-C4 | Spring 의 `@EnabledIf` 와 JUnit Jupiter 5.7+ 의 동명 어노테이션이 공존하므로 패키지 임포트를 명시적으로 구분해야 한다 | [§Important Note] "Since JUnit 5.7, JUnit Jupiter has its own `@EnabledIf` annotation. Ensure you import from the correct package when using Spring's version." | `official-vendor-doc` | JUnit 5.7 이상 + Spring TestContext Framework 동시 사용 환경 | Spring 의 `@EnabledIf` 패키지 경로(`org.springframework.test.context.junit.jupiter`) 를 이 인용이 직접 명시하지는 않음 |
| SPRING-ENABLEDIF-C5 | `@DisabledIf` 는 `@EnabledIf` 의 반대로, 표현식이 `Boolean.TRUE` 또는 대소문자 무관 `"true"` 일 때 테스트를 **비활성화**한다 | [§@DisabledIf / Evaluation Rules] "Test is disabled if expression evaluates to `Boolean.TRUE` or a `String` equal to `true` (ignoring case)" | `official-vendor-doc` | Spring TestContext Framework + JUnit Jupiter 조합 | `@EnabledIf` + `@DisabledIf` 를 동일 메서드에 동시 사용할 때의 우선순위는 이 페이지에서 정의하지 않음 |

## Usage Boundaries / 적용 경계

- 이 자료가 직접 증명하는 것:
  - `SPRING-ENABLEDIF-C1`: `@EnabledIf` 표현식이 `Boolean.TRUE` 또는 `"true"`(ignoring case)일 때 해당 테스트를 실행한다는 공식 평가 규칙
  - `SPRING-ENABLEDIF-C2`: SpEL 및 Spring `Environment` property placeholder 를 표현식으로 사용할 수 있음 — 환경변수 또는 `application.properties` 에 의해 테스트 실행 여부를 제어할 수 있음
  - `SPRING-ENABLEDIF-C3`: `reason` 속성이 존재하며 비활성화 사유를 기록할 수 있음
  - `SPRING-ENABLEDIF-C4`: JUnit 5.7 이후 패키지 충돌 가능성이 공식 문서에 명시됨
  - `SPRING-ENABLEDIF-C5`: `@DisabledIf` 는 동일 평가 규칙으로 테스트를 비활성화함
- 이 자료가 증명하지 않는 것:
  - 표현식이 `false`/`null` 일 때 JUnit 이 `SKIPPED` 를 반환한다는 것을 **명시적**으로 서술하지 않음 (JUnit Jupiter 조건부 실행 API 의 일반 계약에서 파생되는 결과)
  - `loadContext` 속성의 의미와 ApplicationContext 사전 로딩 동작
  - `@EnabledIf` 의 정확한 Spring 패키지 경로
  - property placeholder 의 property 소스 우선순위
- 내 프로젝트에 적용하려면 추가 확인이 필요한 것:
  - ca-skeleton 의 실제 env profile matrix (`APP_ADAPTER_X_ENABLED=false` 등의 property key) 와 `@EnabledIf("${adapter.x.enabled:false}")` 패턴의 실제 동작 검증 필요
  - Spring `@EnabledIf` 의 패키지 임포트 (`org.springframework.test.context.junit.jupiter.EnabledIf`) vs JUnit Jupiter 의 `@EnabledIf` (`org.junit.jupiter.api.condition.EnabledIf`) 충돌 여부 확인

## 메모 / Notes

- WebFetch 가 Spring 공식 문서를 요약·재구성한 출력을 반환하였고, 본 파일의 인용은 그 출력에서 발췌. 공식 문서 HTML 원문과의 완전한 바이트 동일성은 보장되지 않음 — `/ingest` 시 원본 페이지를 재확인 권장.
- D3 의 "SKIPPED, not failed" 의미는 `SPRING-ENABLEDIF-C1` 이 직접 지지하지만, JUnit Jupiter 의 조건부 실행 API 가 `false` 시 `SKIPPED` 를 반환한다는 것은 JUnit 공식 문서(`@EnabledIf` API 계약)로 보강 시 완결됨. 별도 raw source 추가 권장.
- 추가로 봐야 할 동일 출처 페이지: Spring TestContext Framework 전체 어노테이션 페이지 (특히 `loadContext` 속성 설명 섹션)

## Related / 관련

- 같은 주제 다른 official-doc: JUnit Jupiter `@EnabledIf` / `@DisabledIf` 공식 API docs (`org.junit.jupiter.api.condition` 패키지)
- 이 자료를 인용한 wiki 요약: (미작성 — `/ingest` 후 `wiki/concepts/` 에 생성 예정)