Spring Boot YAML vs Properties: Порівняння Конфігурації та Питання для Співбесіди 2026

Spring Boot підтримує два формати конфігурації: YAML (application.yml) та Properties (application.properties). Обидва досягають однієї мети, проте відрізняються синтаксисом, зручністю читання та застосуванням у конкретних сценаріях. Це порівняння розглядає практичні відмінності та охоплює питання, що виникають на співбесідах щодо зовнішньої конфігурації Spring Boot.

Порівняння Синтаксису YAML та Properties

Найбільш помітна відмінність полягає у способі представлення ієрархічних даних. Файли Properties використовують крапкову нотацію в кожному рядку, тоді як YAML застосовує відступи для вираження вкладеності.

# application.properties
server.port=8080
server.servlet.context-path=/api
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.username=admin
spring.datasource.password=${DB_PASSWORD}
spring.jpa.hibernate.ddl-auto=validate
spring.jpa.show-sql=false

Еквівалентна конфігурація YAML візуально групує пов'язані налаштування:

# application.yml
server:
  port: 8080
  servlet:
    context-path: /api

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/mydb
    username: admin
    password: ${DB_PASSWORD}
  jpa:
    hibernate:
      ddl-auto: validate
    show-sql: false

YAML зменшує повторення, коли кілька властивостей мають спільний префікс. У файлі properties spring.datasource з'являється тричі, тоді як YAML оголошує його лише один раз.

Керування Профілями в Конфігурації Spring Boot

Профілі Spring Boot дозволяють мати різні конфігурації для середовищ розробки, staging та production. Обидва формати підтримують профілі, проте YAML обробляє їх елегантніше.

Для файлів properties потрібні окремі файли для кожного профілю:

# application-dev.properties
server.port=8080
spring.datasource.url=jdbc:h2:mem:devdb
logging.level.root=DEBUG

# application-prod.properties
server.port=80
spring.datasource.url=jdbc:postgresql://prod-server:5432/proddb
logging.level.root=WARN

YAML підтримує синтаксис кількох документів в одному файлі за допомогою роздільника ---:

# application.yml
spring:
  profiles:
    active: dev

---
spring:
  config:
    activate:
      on-profile: dev
server:
  port: 8080
logging:
  level:
    root: DEBUG

---
spring:
  config:
    activate:
      on-profile: prod
server:
  port: 80
logging:
  level:
    root: WARN

Починаючи з Spring Boot 2.4, властивість spring.config.activate.on-profile замінила старіший синтаксис spring.profiles. Документація Spring Boot детально описує активацію профілів.

Списки та Складні Структури Даних

YAML чудово справляється з представленням списків та вкладених структур. Це важливо для конфігурацій правил безпеки, CORS-мапінгів або користувацьких бінів.

# application.yml
app:
  security:
    allowed-origins:
      - https://sharpskill.dev
      - https://api.sharpskill.dev
    cors:
      allowed-methods:
        - GET
        - POST
        - PUT
        - DELETE
    jwt:
      secret: ${JWT_SECRET}
      expiration-ms: 86400000

Еквівалент у properties вимагає індексної нотації:

# application.properties
app.security.allowed-origins[0]=https://sharpskill.dev
app.security.allowed-origins[1]=https://api.sharpskill.dev
app.security.cors.allowed-methods[0]=GET
app.security.cors.allowed-methods[1]=POST
app.security.cors.allowed-methods[2]=PUT
app.security.cors.allowed-methods[3]=DELETE
app.security.jwt.secret=${JWT_SECRET}
app.security.jwt.expiration-ms=86400000

Додавання нового origin у файл YAML означає дописування рядка. У properties кожен існуючий індекс повинен залишатися правильним, а новий запис потребує наступного номера індексу.

Типобезпечна Конфігурація з @ConfigurationProperties

Spring Boot 3.4 зв'язує значення конфігурації з Java-класами через @ConfigurationProperties. Обидва формати працюють ідентично з цією анотацією.

import org.springframework.boot.context.properties.ConfigurationProperties;
import java.util.List;

@ConfigurationProperties(prefix = "app.security")
public record AppSecurityProperties(
    List<String> allowedOrigins,
    CorsConfig cors,
    JwtConfig jwt
) {
    public record CorsConfig(List<String> allowedMethods) {}
    public record JwtConfig(String secret, long expirationMs) {}
}

Гнучке зв'язування Spring Boot автоматично конвертує між різними угодами найменування. Властивість app.security.allowed-origins зв'язується з allowedOrigins незалежно від того, чи джерелом є YAML чи properties.

import org.springframework.context.annotation.Configuration;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

@Configuration
@EnableConfigurationProperties(AppSecurityProperties.class)
public class SecurityConfig {
    
    private final AppSecurityProperties securityProperties;
    
    public SecurityConfig(AppSecurityProperties securityProperties) {
        this.securityProperties = securityProperties;
    }
    
    // CORS-конфігурація з використанням securityProperties.cors().allowedMethods()
}

Більше інформації про патерни конфігурації Spring Security можна знайти в модулі основ Spring Security.

Поширені Питання на Співбесіді про Конфігурацію Spring Boot

Конфігурація є частою темою на співбесідах зі Spring Boot. Інтерв'юери оцінюють розуміння зовнішньої конфігурації, налаштувань для конкретних середовищ та зв'язування властивостей.

Питання: Який порядок пріоритетів джерел конфігурації?

Spring Boot завантажує конфігурацію з кількох джерел у певному порядку. Джерела з вищим пріоритетом перевизначають нижчі:

1. Аргументи командного рядка (--server.port=9000)
2. Системні властивості Java (-Dserver.port=9000)
3. Змінні середовища операційної системи (SERVER_PORT=9000)
4. Властивості для конкретного профілю (application-{profile}.yml)
5. Властивості застосунку (application.yml або application.properties)
6. Анотації @PropertySource
7. Властивості за замовчуванням через SpringApplication.setDefaultProperties

Кандидат, який знає цей порядок, демонструє розуміння того, як Spring Boot вирішує конфліктуючі значення.

Питання: Коли обирати properties замість YAML?

Файли properties мають переваги в певних ситуаціях:

• Підтримка IDE: Деякі старіші IDE забезпечують краще автодоповнення для файлів .properties
• Знайомство команди: Синтаксис properties простіший для розробників, нових у Spring Boot
• Однорядкові значення: Плоскі конфігурації без вкладеності нічого не виграють від YAML
• Інтеграція з інструментами збірки: Фільтрація ресурсів Maven та Gradle працює безпосередньо з properties

YAML працює краще, коли:

• Конфігурація має глибоку вкладеність (три або більше рівнів)
• Кілька профілів мають бути в одному файлі
• Списки вимагають частих модифікацій
• Зручність читання важлива для складних конфігурацій

Питання: Як обробляти чутливі значення конфігурації?

Ніколи не слід комітити секрети до системи контролю версій. Spring Boot надає кілька підходів:

# application.yml - посилання на змінну середовища
spring:
  datasource:
    password: ${DB_PASSWORD}

Для production-систем Spring Cloud Config Server або HashiCorp Vault забезпечують централізоване керування секретами. Посібник з моніторингу Actuator охоплює захист чутливих ендпоінтів.

Валідація Конфігурації в Spring Boot 3.4

Spring Boot валідує класи @ConfigurationProperties під час запуску в поєднанні з анотаціями Jakarta Bean Validation.

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Positive;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.validation.annotation.Validated;

@Validated
@ConfigurationProperties(prefix = "app.database")
public record DatabaseProperties(
    @NotBlank String url,
    @NotBlank String username,
    @Positive int poolSize
) {}

Якщо app.database.pool-size відсутній або від'ємний, застосунок швидко завершує роботу під час запуску з чітким повідомленням про помилку. Ця валідація працює ідентично для джерел YAML та properties.

Файли Конфігурації для Конкретних Середовищ

Spring Boot 3.4 підтримує додаткові розташування файлів конфігурації поза стандартним src/main/resources. Властивість spring.config.import завантажує зовнішні файли:

# application.yml
spring:
  config:
    import:
      - optional:file:./config/
      - optional:configserver:http://config-server:8888

Префікс optional: запобігає помилці запуску, коли файл не існує. Цей патерн дозволяє локальну розробку з типовими значеннями, тоді як production отримує конфігурацію з центрального сервера.

Ключові Висновки щодо Конфігурації Spring Boot

• YAML зменшує повторення для конфігурацій зі спільними префіксами та обробляє списки чистіше
• Файли properties добре працюють для плоских конфігурацій та команд, менш знайомих із синтаксисом YAML
• Spring Boot 3.4 однаково ставиться до обох форматів для зв'язування та валідації @ConfigurationProperties
• Керування профілями в YAML тримає пов'язані середовища в одному файлі, зменшуючи розкиданість файлів
• Пріоритет конфігурації слідує визначеному порядку: аргументи командного рядка перевизначають змінні середовища, які перевизначають файлову конфігурацію
• Чутливі значення мають бути у змінних середовища або системах керування секретами, ніколи у файлах під контролем версій
• Використання spring.config.import дозволяє завантажувати конфігурацію із зовнішніх джерел у production-середовищах