如何在Micronaut中使ConfigurationProperties字段强制必填？

方法1：使用Micronaut原生@Required注解 #

直接在需要强制必填的字段上添加io.micronaut.core.annotation.Required注解，应用启动时若对应配置缺失，会直接抛出异常终止启动，无需额外配置。

修改后的代码示例：

import io.micronaut.context.annotation.ConfigurationProperties
import io.micronaut.core.annotation.Required

@ConfigurationProperties("foo.properties") 
class WaterStreetProperties {    
    @Required
    lateinit var fooProp: String  

    @Required
    lateinit var fooProp2: String   

    @Required
    lateinit var fooProp3: String   

    @Required
    lateinit var fooProp4: String 
}

该注解属于Micronaut核心模块，一般项目默认依赖已包含，无需额外引入。

方法2：结合JSR-380验证注解 #

如果需要更灵活的验证规则（比如格式、长度校验），可以用JSR-380的@NotNull配合Micronaut的验证功能：

1. 先添加验证依赖（以Gradle为例）：

implementation "io.micronaut.validation:micronaut-validation"

2. 在配置类上加@Validated，字段加@NotNull：

import io.micronaut.context.annotation.ConfigurationProperties
import io.micronaut.validation.Validated
import javax.validation.constraints.NotNull

@Validated
@ConfigurationProperties("foo.properties") 
class WaterStreetProperties {    
    @NotNull
    lateinit var fooProp: String  

    @NotNull
    lateinit var fooProp2: String   

    @NotNull
    lateinit var fooProp3: String   

    @NotNull
    lateinit var fooProp4: String 
}

启动时若配置缺失或不符合规则，会抛出ConstraintViolationException并终止应用。

关于你尝试方案无效的原因说明 #

• 数据类无法启动：Micronaut对Kotlin数据类的支持需要配合@ConstructorBinding注解（Micronaut 3.x及以上版本），确保构造函数参数能被正确注入，同时结合@Required或@NotNull即可生效。
• final字段无法填充：final字段必须通过构造函数注入，需要给配置类添加@ConstructorBinding注解，示例如下：

import io.micronaut.context.annotation.ConfigurationProperties
import io.micronaut.core.annotation.Required
import io.micronaut.context.annotation.ConstructorBinding

@ConstructorBinding
@ConfigurationProperties("foo.properties") 
class WaterStreetProperties(
    @Required val fooProp: String,
    @Required val fooProp2: String,
    @Required val fooProp3: String,
    @Required val fooProp4: String
)

这种写法下所有final字段均为必填，缺失配置会直接导致启动失败，之前无效大概率是遗漏了@ConstructorBinding注解。

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