Spring Boot中src包内Autowiring注入为null的问题求助

云上老周

2026-5-6

解决Spring Boot+Cucumber项目中src/main/java组件注入null的问题

我来帮你拆解这个问题——本质上是Spring容器管理范围的典型问题，先理清楚根因，再给你具体的解决步骤：

问题背景回顾

你的测试框架技术栈是Java、Maven、Selenium、JUnit、Cucumber、Spring Boot、YAML，依赖和启动类都配置到位了，src/test/java下的Cucumber步骤类能正常用@Autowired注入依赖，但src/main/java下的组件注入却返回null。

核心原因

src/test下的类能正常注入，是因为@SpringBootTest注解已经帮你启动了Spring容器，并且自动扫描管理了相关Bean。但src/main下的类如果没被Spring容器接管，或者你是手动new出来的对象，Spring根本没法给它注入任何依赖，自然就会出现null。

具体解决步骤

1. 确保src/main下的组件被Spring扫描并托管

首先检查你的src/main/java组件类是否添加了Spring的托管注解：

通用组件加@Component
业务服务类加@Service
数据访问类加@Repository
配置类加@Configuration
Web控制器加@Controller/@RestController

另外要保证这些类在@SpringBootApplication的扫描范围内：你的启动类在io.tpd.springbootcucumber包下，所以组件类在这个包或其子包下会被自动扫描。如果组件在其他包，需要在启动类上补充@ComponentScan指定扫描路径：

@SpringBootApplication
@ComponentScan(basePackages = {"io.tpd.springbootcucumber", "com.your.other.package"})
public class SpringBootCucumberApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringBootCucumberApplication.class, args);
    }
}

2. 绝对不要手动new需要注入依赖的对象

如果你在代码里写了new YourComponent()，这个对象完全脱离Spring容器，Spring不可能给它注入任何依赖。正确的做法是：

在其他Spring托管类中，用@Autowired注入这个组件
如果是在非Spring托管的类里（比如工具类），要么把工具类也加@Component交给Spring管理，要么通过ApplicationContext获取Bean（应急可用，但更推荐前者）：

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class YourToolClass {
    private Config config;

    public YourToolClass() {
        ApplicationContext context = new AnnotationConfigApplicationContext(SpringBootCucumberApplication.class);
        this.config = context.getBean(Config.class);
    }
}

3. 检查自定义配置类的加载逻辑

如果你的Config是绑定YAML的配置类，要确保：

要么在启动类上加@EnableConfigurationProperties(Config.class)
要么给Config类本身加@Component注解
同时确认application.yml放在src/main/resources目录下，Spring能正常读取到配置内容。

4. Cucumber场景下的额外注意

如果src/main的组件是被src/test的Cucumber步骤类调用，一定要通过@Autowired注入组件，而不是手动new。比如在步骤类里注入src/main的服务类，再调用其方法，这样服务类内部的依赖也会被Spring正常注入。

快速验证方法

可以给src/main的组件加个构造方法打印日志，确认Spring是否成功加载了它：

@Component
public class Config {
    public Config() {
        System.out.println("✅ Config bean has been initialized by Spring");
    }
}

启动应用或运行Cucumber测试时，如果能看到这条日志，说明Bean已经被Spring管理，此时@Autowired就不会返回null了。

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

Spring Boot中src包内Autowiring注入为null的问题求助

问题背景回顾 #

核心原因 #

具体解决步骤 #