Spring Boot Kotlin无法从application.yml获取配置值问题

问题描述 #

尝试了多种方式从application.yml文件中读取配置值，但获取到的值始终为null。

配置文件内容（application.yml） #

demo-control:
  environment: ${ENVIRONMENT:prod}
  managedRegions: ${MANAGED_REGIONS:us-east-1}

已尝试的实现方式 #

组件类尝试1 #

import org.springframework.beans.factory.annotation.Value
import org.springframework.stereotype.Component

@Component
class AppProperties(@Value("\${demo-control.managedRegions}") private val managedRegions: String)

组件类尝试2 #

@Component
class AppProperties {
    @Value("\${demo-control.managedRegions}")
    lateinit var managedRegions: String
}

目标使用类（AwsProvider）的尝试 #

// Attempt1
class AwsProvider(
    private val creds: AwsCredentials,
    @Value("\${demo-control.managedRegions}")
    private val managedRegions: String? = null
) : CloudProvider

// Attempt2
class AwsProvider(
    private val creds: AwsCredentials
) : CloudProvider {
    @Value("\${demo-control.managedRegions}")
    lateinit var region: String
}

解决方案及排查要点 #

• 确保类被Spring容器管理

  • AwsProvider类必须添加@Component/@Service等Spring组件注解，否则Spring不会识别并处理其中的@Value注解。如果是手动new实例，Spring完全不会参与注入流程，值必然为null。
  • 检查AppProperties所在包是否被Spring扫描覆盖：启动类所在包需包含组件类包，或通过@ComponentScan显式指定扫描范围。

• 修正构造注入的写法

  • 构造函数参数中的@Value不要设置默认值= null，否则Spring可能直接使用默认值而非注入配置值。正确写法：

    class AwsProvider(
        private val creds: AwsCredentials,
        @Value("\${demo-control.managedRegions}")
        private val managedRegions: String?
    ) : CloudProvider
    

• 验证配置文件加载有效性

  • 确认application.yml放在src/main/resources目录下（Spring默认加载路径），如果是多环境配置，需确保激活的环境配置文件正确。
  • 临时去掉环境变量占位符，直接写死managedRegions: us-east-1测试，排查是否是环境变量MANAGED_REGIONS被设为空值导致覆盖默认值。

• 注意Kotlin lateinit的使用时机

  • 使用lateinit var时，必须在Spring完成注入后再访问变量，避免抛出UninitializedPropertyAccessException。建议在@PostConstruct方法中初始化或使用该变量。

内容的提问来源于stack exchange，提问作者user18282672