Spring Boot启动时JSR-303注解未验证配置Bean问题求助

我明白你的痛点——明明给AdminConfig加了JSR-303验证注解，但没设置环境变量时Bean照样创建，应用还正常启动，完全不符合预期。别担心，这是因为Spring Boot默认不会在Bean初始化阶段自动触发JSR-303验证，咱们只需要做几个简单配置就能搞定，让验证失败直接阻断应用启动。

第一步：确保依赖到位 #

首先得确认你的POM里已经引入了Spring Boot的验证 starter（Spring Boot 2.3+ 这个依赖不再默认包含在web starter里，必须手动加）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

第二步：给配置Bean添加触发验证的注解 #

光有@NotNull、@NotBlank这类JSR-303注解还不够，必须给你的AdminConfig加上@Validated注解，告诉Spring要对这个Bean的属性做验证。

情况1：用@ConfigurationProperties绑定环境变量

如果你的AdminConfig是用@ConfigurationProperties来绑定环境变量的，代码应该这么写：

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

@Validated // 关键注解，触发验证
@ConfigurationProperties(prefix = "admin") // 绑定以admin开头的环境变量
public class AdminConfig {
    @NotBlank(message = "必须设置ADMIN_USERNAME环境变量")
    private String username;

    @NotBlank(message = "必须设置ADMIN_PASSWORD环境变量")
    private String password;

    // 别忘了生成getter和setter
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public String getPassword() { return password; }
    public void setPassword(String password) { this.password = password; }
}

然后在你的启动类或者任意配置类上加上@EnableConfigurationProperties(AdminConfig.class)，让Spring识别这个配置类：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

@SpringBootApplication
@EnableConfigurationProperties(AdminConfig.class) // 启用配置属性绑定
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

情况2：用@Value直接注入环境变量

如果是用@Value注解直接注入环境变量，给AdminConfig加上@Component和@Validated即可：

import javax.validation.constraints.NotBlank;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import org.springframework.validation.annotation.Validated;

@Component
@Validated // 关键注解
public class AdminConfig {
    @Value("${admin.username}")
    @NotBlank(message = "必须设置ADMIN_USERNAME环境变量")
    private String username;

    @Value("${admin.password}")
    @NotBlank(message = "必须设置ADMIN_PASSWORD环境变量")
    private String password;

    // getter和setter可选，根据需求添加
}

第三步：让验证失败立即终止启动（可选） #

如果希望只要有一个验证失败就立刻停止应用启动，不用等到所有验证完成，可以在application.properties（或yaml）里加这个配置：

spring.validation.fail-fast=true

验证效果 #

现在当你不设置对应的环境变量启动应用时，Spring会在初始化AdminConfig的时候触发验证，抛出ConstraintViolationException异常，直接终止应用启动，完全符合你的预期。

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