Spring Boot 2.7非控制器类@Value无法读取application.properties问题

核心问题 1：手动实例化对象脱离Spring容器管理 #

你通过var bitBucket = new BitBucket();手动创建对象，这个对象不在Spring的IoC容器管控范围内。Spring只会对自己创建并管理的Bean处理@Value、@Autowired等注解，手动new出来的对象不会触发属性注入，所以bitBucketUsername和bitBucketPassword始终为null。

核心问题 2：构造函数执行时机早于属性注入 #

即使是Spring管理的Bean，构造函数的执行也在@Value属性注入之前。原代码在构造函数里调用createRestTemplate()，此时注入的属性还未赋值，同样会得到null。

修复步骤 #

1. 改用Spring依赖注入获取BitBucket实例

在需要使用BitBucket的类（比如控制器、其他@Component类）中，通过Spring的依赖注入方式获取Bean，禁止手动new：

// 推荐构造注入（Spring官方推荐）
@RestController
public class YourController {
    private final BitBucket bitBucket;

    public YourController(BitBucket bitBucket) {
        this.bitBucket = bitBucket;
    }

    // ... 业务逻辑
}

// 或者字段注入（不推荐，但简单场景可用）
@RestController
public class YourController {
    @Autowired
    private BitBucket bitBucket;

    // ... 业务逻辑
}

2. 修正BitBucket类的初始化逻辑

提供两种可行方案：

方案A：使用@PostConstruct延迟初始化RestTemplate

@PostConstruct注解的方法会在Bean构造完成、所有属性注入完成后执行，此时@Value的属性已经赋值：

@Component
public class BitBucket {
    
    private final Logger logger = LoggerFactory.getLogger(BitBucket.class);
    @Value("${app.bitbucket_username}")
    private String bitBucketUsername;
    @Value("${app.bitbucket_password}")
    private String bitBucketPassword;
    private RestTemplate restTemplate;

    // 空构造函数（可省略，Spring会自动生成）
    public BitBucket() {}

    @PostConstruct
    private void initRestTemplate() {
        this.restTemplate = createRestTemplate();
    }

    private RestTemplate createRestTemplate() {
        var builder = new RestTemplateBuilder();
        logger.info("The user is " + bitBucketUsername);
        logger.info("The pw is " + bitBucketPassword);
        return builder
            .setConnectTimeout(Duration.ofMillis(3000))
            .setReadTimeout(Duration.ofMillis(5000))
            .basicAuthentication(bitBucketUsername, bitBucketPassword) // 修正原代码变量名错误
            .build();
    }
}

方案B：构造注入@Value属性（更推荐）

直接通过构造函数注入@Value属性，在构造时就能直接使用属性值初始化RestTemplate，避免依赖@PostConstruct：

@Component
public class BitBucket {
    
    private final Logger logger = LoggerFactory.getLogger(BitBucket.class);
    private final String bitBucketUsername;
    private final String bitBucketPassword;
    private final RestTemplate restTemplate;

    // 构造函数注入配置属性
    public BitBucket(@Value("${app.bitbucket_username}") String bitBucketUsername,
                     @Value("${app.bitbucket_password}") String bitBucketPassword) {
        this.bitBucketUsername = bitBucketUsername;
        this.bitBucketPassword = bitBucketPassword;
        this.restTemplate = createRestTemplate();
    }

    private RestTemplate createRestTemplate() {
        var builder = new RestTemplateBuilder();
        logger.info("The user is " + bitBucketUsername);
        logger.info("The pw is " + bitBucketPassword);
        return builder
            .setConnectTimeout(Duration.ofMillis(3000))
            .setReadTimeout(Duration.ofMillis(5000))
            .basicAuthentication(bitBucketUsername, bitBucketPassword)
            .build();
    }
}

额外说明 #

原代码中createRestTemplate()方法里的basicAuthentication(username, password)存在变量名错误，应该改为bitBucketUsername和bitBucketPassword，否则即使注入成功也会报错。

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