Spring Boot 2.0.0中@Value注入返回null的排查求助

我来帮你排查一下@Value注入返回null的问题，结合你的代码和Spring Boot 2.0.0的特性，大概率是这几个地方出了问题，咱们一个个来核对：

1. 确保VZProperties被Spring容器正确扫描并管理 #

@Configuration注解确实会让Spring把这个类识别为配置Bean，但前提是它处于Spring的扫描范围内。Spring Boot默认会扫描启动类所在包及其子包下的组件：

• 检查你的启动类（比如XxxApplication）的包路径，是不是和VZProperties的包有包含关系？比如启动类在com.yourcompany，而VZProperties在com.yourcompany.config，这就没问题；如果VZProperties在com.otherpackage，那Spring扫不到它，自然不会处理@Value注入。
• 解决办法：要么把VZProperties移到启动类的子包下，要么在启动类上手动指定扫描范围：

  @SpringBootApplication(scanBasePackages = {"com.yourcompany", "com.otherpackage"})
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

2. 绝对不要手动new实例，必须通过Spring注入获取 #

这是新手最容易踩的坑！如果你在使用VZProperties的地方是这样写的：

// 错误写法！这样new出来的对象不受Spring管理，@Value不会生效
VZProperties props = new VZProperties();
String version = props.getApiVersion(); // 这里肯定是null

正确的做法是通过Spring的依赖注入来获取Bean，推荐用构造注入（Spring官方推荐，避免空指针）：

import org.springframework.stereotype.Service;

@Service
public class YourService {
    private final VZProperties vzProperties;

    // 构造注入，Spring会自动把VZProperties的实例传进来
    public YourService(VZProperties vzProperties) {
        this.vzProperties = vzProperties;
    }

    public void doSomething() {
        String version = vzProperties.getApiVersion(); // 这里就能拿到正确的值了
    }
}

或者用@Autowired字段注入（虽然可行，但不如构造注入安全）：

@Service
public class YourService {
    @Autowired
    private VZProperties vzProperties;

    // ...
}

3. 确认配置文件被正确加载 #

检查你的application.properties是否放在src/main/resources目录下——这是Spring Boot默认加载配置文件的位置。如果你的配置文件在其他路径，需要在VZProperties上添加@PropertySource注解指定路径：

@Configuration
@PropertySource("classpath:config/custom.properties") // 替换成你的配置文件路径
public class VZProperties {
    @Value("${vz.info.version}")
    @Getter @Setter
    private String apiVersion;
}

另外还要核对配置键的拼写：vz.info.version在配置文件和@Value注解里必须完全一致（properties文件是大小写敏感的），别打错字！

4. 验证Lombok注解是否生效 #

虽然这不是@Value注入null的直接原因，但如果Lombok的@Getter@Setter没生效，你可能会误以为是注入失败。可以做个简单验证：

• 确认你的Maven/Gradle依赖里已经添加了Lombok：
  Maven：

  <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <optional>true</optional>
  </dependency>
  

  Gradle：

  compileOnly 'org.projectlombok:lombok'
  annotationProcessor 'org.projectlombok:lombok'
  

• 确保你的IDE安装了Lombok插件（比如IntelliJ IDEA需要在Settings里搜索Lombok并启用）。

完整可运行示例 #

给你贴一个完整的正确代码结构，你可以对照调整：

启动类（放在根包） #

package com.vz.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class VzDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(VzDemoApplication.class, args);
    }
}

配置类（放在根包的子包） #

package com.vz.demo.config;

import lombok.Getter;
import lombok.Setter;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;

@Configuration
public class VZProperties {
    @Value("${vz.info.version}")
    @Getter @Setter
    private String apiVersion;
}

使用配置的Service类 #

package com.vz.demo.service;

import com.vz.demo.config.VZProperties;
import org.springframework.stereotype.Service;

@Service
public class VersionService {
    private final VZProperties vzProperties;

    public VersionService(VZProperties vzProperties) {
        this.vzProperties = vzProperties;
    }

    public String getApiVersion() {
        return vzProperties.getApiVersion();
    }
}

application.properties（src/main/resources下） #

vz.info.version=0.2.8

按照这个结构调整后，再测试应该就能正常获取到属性值了。

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