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

> Детальне порівняння форматів конфігурації YAML та Properties у Spring Boot. Аналіз синтаксису, керування профілями, структур даних та найпоширеніших питань на співбесідах.

- Published: 2026-08-26
- Updated: 2026-08-26
- Author: Anthony Fillion-Maillet
- Tags: spring-boot, конфігурація, yaml, properties, співбесіда
- Reading time: 9 min

---

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

> **Швидкий Посібник з Вибору**
>
> YAML підходить для проєктів із глибоко вкладеною конфігурацією або кількома профілями. Properties варто використовувати для простих плоских конфігурацій або в командах, не знайомих із синтаксисом YAML.

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

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

```properties
# 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 візуально групує пов'язані налаштування:

```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 потрібні окремі файли для кожного профілю:

```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 підтримує синтаксис кількох документів в одному файлі за допомогою роздільника `---`:

```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](https://docs.spring.io/spring-boot/reference/features/external-config.html) детально описує активацію профілів.

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

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

```yaml
# 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 вимагає індексної нотації:

```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`. Обидва формати працюють ідентично з цією анотацією.

```java
// AppSecurityProperties.java
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.

```java
// SecurityConfig.java
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](/technologies/spring-boot/interview-questions/spring-security-basics).

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

Конфігурація є частою темою на [співбесідах зі Spring Boot](/technologies/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 надає кілька підходів:

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

Для production-систем Spring Cloud Config Server або HashiCorp Vault забезпечують централізоване керування секретами. [Посібник з моніторингу Actuator](/blog/spring-boot/spring-boot-actuator-monitoring-micrometer-prometheus) охоплює захист чутливих ендпоінтів.

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

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

```java
// DatabaseProperties.java
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` завантажує зовнішні файли:

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

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

| Функція | YAML | Properties |
|---------|------|------------|
| Вкладена конфігурація | Нативна ієрархія | Крапкова нотація |
| Кілька профілів в одному файлі | Підтримується через `---` | Потребує окремих файлів |
| Синтаксис списків | Нативні YAML-масиви | Індексна нотація `[0]`, `[1]` |
| Коментарі | `#` у будь-якому рядку | `#` або `!` у будь-якому рядку |
| Автодоповнення IDE | Добре в IntelliJ, VS Code | Відмінне у всіх IDE |
| Крива навчання | Потребує знання YAML | Мінімальна |

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

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

---

Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack.
HTML version of this page: https://sharpskill.dev/uk/blog/spring-boot/spring-boot-yaml-vs-properties-configuration-comparison