Spring Boot中@Value注入字段在@Autowired调用时为null的问题

这不是预期行为，是操作中出现了问题，核心原因通常是Spring容器中存在多实例、Bean代理导致字段访问失效，或初始化顺序异常。

可能的原因及解决办法 #

• 容器中存在多个FirstService实例
  如果你通过手动new FirstService()、其他配置类重复实例化等方式生成了多个对象，CommandLineRunner中注入的可能是未完成@Value注入的实例。
  解决：

  • 确保FirstService仅通过@Service注解由Spring容器管理，不要手动创建实例。
  • 检查是否有其他配置类重复定义了该Bean，必要时用@Qualifier指定注入的Bean名称。

• Bean被AOP代理导致字段访问失效
  如果FirstService被Spring AOP增强（比如加了@Transactional、自定义切面），Spring会生成代理类，直接访问public字段会绕过代理逻辑，导致无法获取注入的值。
  解决（推荐最佳实践）：
  将字段设为私有，通过getter方法访问：

  @Service
  public class FirstService{
     
      @Value("${test.localDirectory}")
      private String localDirectory;
  
      public String getLocalDirectory() {
          return localDirectory;
      }
  }
  

  然后在CommandLineRunner中调用firstService.getLocalDirectory()获取值。

• 初始化顺序异常（概率较低）
  虽然CommandLineRunner的run方法默认在所有Bean初始化完成后执行，但特殊依赖配置可能导致注入的Bean未完全初始化。
  解决：

  • 若FirstService依赖其他Bean，可添加@DependsOn指定依赖顺序；
  • 检查配置文件中是否有影响Bean加载优先级的设置。

快速验证方法 #

在FirstService中添加构造日志，对比实例哈希值，确认是否为同一个对象：

@Service
public class FirstService implements InitializingBean{
    private static final Logger logger = LoggerFactory.getLogger(FirstService.class);
     
    @Value("${test.localDirectory}")
    public String localDirectory;

    public FirstService() {
        logger.info("FirstService实例创建: {}", this.hashCode());
    }

    @Override
    public void afterPropertiesSet() throws Exception {
        logger.info("afterPropertiesSet - 实例哈希: {}, localDirectory值: {}", this.hashCode(), localDirectory);
    }
}

@Component
public class CommandLineRunnerExecutor implements CommandLineRunner {
    private static final Logger logger = LoggerFactory.getLogger(CommandLineRunnerExecutor.class);
    @Autowired
    private FirstService firstService;

    @Override
    public void run(String... args) throws Exception {
        logger.info("CommandLineRunner - FirstService实例哈希: {}, localDirectory值: {}", firstService.hashCode(), firstService.localDirectory);
    }
}

• 若哈希值不一致：说明存在多个实例，按第一种原因排查；
• 若哈希值一致但字段为null：大概率是代理问题，改用getter方法即可解决。

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