Что имеет приоритет при загрузке внешних конфигураций в Spring

Приоритет загрузки конфигураций в Spring

Приоритет конфигураций в Spring определяет, какое значение будет использовано, если одно и то же свойство определено в нескольких местах. Это критически важно для управления конфигурациями в разных окружениях.

Порядок приоритетов (от высшего к низшему)

1. Command-line аргументы (системные свойства JVM)
2. Переменные окружения ОС
3. application.properties файл в текущей директории
4. application.yml файл в текущей директории
5. application-{profile}.properties на classpath
6. application-{profile}.yml на classpath
7. application.properties на classpath (базовый)
8. application.yml на classpath (базовый, низший приоритет)

Практический пример

@Configuration
@EnableConfigurationProperties
public class AppConfig {
    
    @Value("${app.name:DefaultName}")
    private String appName;
    
    @Value("${app.version:1.0}")
    private String appVersion;
    
    @PostConstruct
    public void printConfig() {
        System.out.println("App: " + appName);
        System.out.println("Version: " + appVersion);
    }
}

Примеры файлов конфигурации

# application.yml (основной)
app:
  name: DefaultApp
  version: 1.0
  port: 8080

# application-production.yml
app:
  name: ProductionApp
  version: 2.0
  port: 9000

Запуск с разными конфигурациями

# 1. Использует application.yml
java -jar application.jar
# Output: App: DefaultApp, Version: 1.0

# 2. Использует application-production.yml
java -Dspring.profiles.active=production -jar application.jar
# Output: App: ProductionApp, Version: 2.0

# 3. Command-line перебивает всё
java -Dspring.profiles.active=production -Dapp.name=CLIApp -jar application.jar
# Output: App: CLIApp, Version: 2.0

# 4. Environment variable
APP_NAME=EnvApp java -jar application.jar
# Output: App: EnvApp

ConfigurationProperties для структурированной конфигурации

@Configuration
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    
    private String name;
    private String version;
    private int port;
    private Database database = new Database();
    
    public static class Database {
        private String host;
        private int maxConnections;
        
        // getters/setters
    }
    
    // getters/setters
}

app:
  name: MyApp
  version: 1.0
  port: 8080
  database:
    host: localhost
    maxConnections: 20

Типичная структура файлов конфигурации

src/main/resources/
├── application.yml                    # базовая для всех
├── application-development.yml        # dev профиль
├── application-test.yml              # test профиль
└── application-production.yml        # prod профиль

Пример конфигурации для разных окружений

# application.yml
spring:
  application:
    name: my-app
  jpa:
    hibernate:
      ddl-auto: validate

app:
  cache-enabled: true

# application-development.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dev_db
    username: dev_user
    password: dev_password
  jpa:
    show-sql: true

app:
  debug: true
  cache-enabled: false

# application-production.yml
spring:
  datasource:
    url: jdbc:mysql://prod-server:3306/prod_db
    username: ${DB_USER}
    password: ${DB_PASSWORD}
  jpa:
    show-sql: false

app:
  debug: false
  cache-enabled: true

Запуск с профилем

# Development
java -Dspring.profiles.active=development -jar application.jar

# Production
java -Dspring.profiles.active=production -jar application.jar

# Несколько профилей
java -Dspring.profiles.active=production,cache -jar application.jar

Переменные окружения для чувствительных данных

# application-production.yml
spring:
  datasource:
    url: ${DATABASE_URL}
    username: ${DATABASE_USER}
    password: ${DATABASE_PASSWORD}
  mail:
    password: ${MAIL_PASSWORD}

# Запуск с environment переменными
export DATABASE_URL=jdbc:mysql://prod:3306/db
export DATABASE_USER=admin
export DATABASE_PASSWORD=secret123

java -Dspring.profiles.active=production -jar application.jar

Проверка загруженной конфигурации

@Component
public class ConfigDebugger {
    
    @Value("${app.name}")
    private String appName;
    
    @Value("${spring.profiles.active:default}")
    private String activeProfiles;
    
    @PostConstruct
    public void printConfig() {
        System.out.println("Active profiles: " + activeProfiles);
        System.out.println("App name: " + appName);
    }
}

Типичные ошибки

Ошибка 1: Секреты в application.properties

# НИКОГДА ТАК!
spring.datasource.password=SuperSecret123

Ошибка 2: Несоответствие имён переменных

@Value("${database.url}")
// но в yml: datasource.url  // ОШИБКА!

Ошибка 3: Забыть установить профиль

java -jar application.jar  # использует базовые значения

Best Practices

1. Используй environment переменные для секретов в production
2. Профили для разных окружений (dev, test, prod)
3. ConfigurationProperties для структурированной конфигурации
4. Валидация конфигураций с @Validated и @NotNull
5. Логирование загруженной конфигурации для отладки

Важные моменты

System Properties (-D флаг) имеют высокий приоритет над файлами, что позволяет переопределять конфигурацию при запуске без изменения кода.

Environment variables используются для чувствительных данных (пароли, API ключи) в production, не попадают в git.

Профили позволяют иметь разные конфигурации для разных окружений без дублирования.

Вывод

Приоритет конфигураций в Spring: Command-line arguments > Environment variables > File-based. Это позволяет гибко управлять конфигурацией для разных окружений. Типичная практика: использовать application.yml для базовых значений, application-{profile}.yml для специфичных окружений, и environment переменные для чувствительных данных. Это стандартный подход в production системах.