Spring Boot application.yml to ENV Conversion

Spring Boot has a unique relationship between YAML configuration and environment variables. Its "relaxed binding" feature allows environment variables to override YAML properties following specific naming conventions.

Spring Boot application.yml:

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/mydb
    username: dbuser
    password: dbpass
    hikari:
      maximum-pool-size: 10
      minimum-idle: 5
      connection-timeout: 30000
  jpa:
    hibernate:
      ddl-auto: validate
    show-sql: false
  redis:
    host: localhost
    port: 6379
server:
  port: 8080
  servlet:
    context-path: /api
logging:
  level:
    root: INFO
    com.example.myapp: DEBUG
    org.hibernate.SQL: DEBUG

Equivalent environment variables:

SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/mydb
SPRING_DATASOURCE_USERNAME=dbuser
SPRING_DATASOURCE_PASSWORD=dbpass
SPRING_DATASOURCE_HIKARI_MAXIMUM_POOL_SIZE=10
SPRING_DATASOURCE_HIKARI_MINIMUM_IDLE=5
SPRING_DATASOURCE_HIKARI_CONNECTION_TIMEOUT=30000
SPRING_JPA_HIBERNATE_DDL_AUTO=validate
SPRING_JPA_SHOW_SQL=false
SPRING_REDIS_HOST=localhost
SPRING_REDIS_PORT=6379
SERVER_PORT=8080
SERVER_SERVLET_CONTEXT_PATH=/api
LOGGING_LEVEL_ROOT=INFO
LOGGING_LEVEL_COM_EXAMPLE_MYAPP=DEBUG
LOGGING_LEVEL_ORG_HIBERNATE_SQL=DEBUG

Spring Boot's relaxed binding rules:

1. Dots become underscores. spring.datasource.url -> SPRING_DATASOURCE_URL
2. Hyphens become underscores. maximum-pool-size -> MAXIMUM_POOL_SIZE
3. Everything is uppercased. spring -> SPRING
4. Nested keys are joined with underscores. Each YAML nesting level adds an underscore separator.

Special handling for lists:

spring:
  profiles:
    active:
      - dev
      - debug

SPRING_PROFILES_ACTIVE=dev,debug
# or with indexed notation:
SPRING_PROFILES_ACTIVE_0=dev
SPRING_PROFILES_ACTIVE_1=debug

Map keys with dots (logging levels): The logging.level section maps package names to levels. The dots in package names (com.example.myapp) become underscores, which can create ambiguity. Spring resolves this by checking the full property path.

Common gotchas:

• ddl-auto (with hyphen) and ddlAuto (camelCase) both map to DDL_AUTO in ENV
• Boolean values in YAML (show-sql: false) become strings in ENV (SHOW_SQL=false)
• Context paths with slashes (/api) should not be quoted differently between formats

Spring Boot's relaxed binding makes YAML-to-ENV conversion reliable, but the reverse (ENV-to-YAML) requires knowledge of the original YAML structure to reconstruct proper nesting.