Environment와 Profile — 환경마다 다른 설정을 어떻게 관리할까

# application.yml
spring:
  profiles:
    active: dev  # dev 프로파일 활성화

# 커맨드 라인
java -jar app.jar --spring.profiles.active=prod

# 환경 변수
export SPRING_PROFILES_ACTIVE=prod

# JVM 시스템 프로퍼티
java -Dspring.profiles.active=prod -jar app.jar

src/main/resources/
├── application.yml           # 공통 설정
├── application-dev.yml       # dev 프로파일 설정
├── application-prod.yml      # prod 프로파일 설정
└── application-test.yml      # test 프로파일 설정

# application.yml (공통)
server:
  port: 8080
spring:
  application:
    name: my-app

# application-dev.yml
spring:
  datasource:
    url: jdbc:h2:mem:devdb
    driver-class-name: org.h2.Driver
logging:
  level:
    root: DEBUG

# application-prod.yml
spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/myapp
    driver-class-name: com.mysql.cj.jdbc.Driver
logging:
  level:
    root: WARN

# application-prod.yml
spring:
  profiles:
    include:
      - prod-db       # 항상 함께 활성화
      - prod-cache

# application.yml
spring:
  profiles:
    group:
      prod:
        - prod-db
        - prod-cache
        - prod-monitoring
      dev:
        - dev-db
        - dev-mock

1. 커맨드 라인 인자 (--server.port=9090)
2. JVM 시스템 프로퍼티 (-Dserver.port=9090)
3. OS 환경 변수 (SERVER_PORT=9090)
4. 프로파일별 외부 application-{profile}.yml
5. 프로파일별 내부 application-{profile}.yml
6. 외부 application.yml
7. 내부 application.yml (src/main/resources)
8. @PropertySource
9. 기본값

public interface StorageService {
    void store(String filename, byte[] data);
}

@Profile("dev")
@Service
public class LocalStorageService implements StorageService {
    @Override
    public void store(String filename, byte[] data) {
        // 로컬 파일 시스템에 저장
        Files.write(Path.of("/tmp/uploads/" + filename), data);
    }
}

@Profile("prod")
@Service
public class S3StorageService implements StorageService {
    @Override
    public void store(String filename, byte[] data) {
        // AWS S3에 업로드
        s3Client.putObject(PutObjectRequest.builder()
            .bucket("my-bucket")
            .key(filename)
            .build(), RequestBody.fromBytes(data));
    }
}

@Profile("dev")              // dev일 때만
@Profile("!prod")            // prod가 아닐 때
@Profile({"dev", "test"})    // dev 또는 test일 때
@Profile("prod & secure")    // prod이면서 secure일 때 (Spring 5.1+는 표현식 지원 제한적)

@Service
@RequiredArgsConstructor
public class FeatureToggleService {
    private final Environment environment;

    public boolean isFeatureEnabled(String feature) {
        // 현재 활성 프로파일 확인
        if (environment.acceptsProfiles(Profiles.of("beta"))) {
            return true; // beta 프로파일이면 모든 기능 활성화
        }

        // 프로퍼티 값으로 기능 토글
        return environment.getProperty("feature." + feature + ".enabled",
                                        Boolean.class, false);
    }

    public void printActiveProfiles() {
        String[] profiles = environment.getActiveProfiles();
        System.out.println("활성 프로파일: " + Arrays.toString(profiles));
    }
}

@Configuration
@PropertySource("classpath:custom.properties")
@PropertySource("classpath:${app.config.location:defaults}.properties")
public class CustomPropertyConfig {
    // custom.properties 파일의 프로퍼티가 Environment에 추가됨
}

@SpringBootTest
@ActiveProfiles("test")
class OrderServiceTest {
    // test 프로파일 설정으로 테스트 실행
    // application-test.yml의 설정이 적용됨
}

# 공통 설정
server:
  port: 8080

---
# dev 프로파일
spring:
  config:
    activate:
      on-profile: dev
  datasource:
    url: jdbc:h2:mem:devdb

---
# prod 프로파일
spring:
  config:
    activate:
      on-profile: prod
  datasource:
    url: jdbc:mysql://prod-db:3306/myapp

# application.yml
my-app:
  api:
    base-url: https://api.example.com
    timeout-seconds: 30

# 환경 변수로 오버라이드 (relaxed binding)
MY_APP_API_BASE_URL=https://staging-api.example.com
MY_APP_API_TIMEOUT_SECONDS=60