Spring报Invalid autowire-marked constructor异常解决方法

Spring IoC容器实例化Bean时，对构造器注入有明确约束：单个Bean默认仅允许存在1个标记为@Autowired(required = true)的构造函数。
你当前的HomeController中写了两个独立的重载构造方法，且两个构造方法都添加了默认required属性为true的@Autowired注解：一个构造仅注入CustomerService依赖，另一个构造仅注入ProductService依赖。容器启动时扫描到两个符合注入要求的构造器，无法判定该调用哪个构造器完成HomeController的实例化，就会抛出Invalid autowire-marked constructor核心错误，最终包装为BeanCreationException抛出。
你定义的CustomerService、ProductService类上添加的@Service、@Transactional注解没有问题，两个服务类本身可以被Spring正常扫描注册为Bean，不需要修改这两个类的代码。

你当前HomeController的错误写法逻辑如下：

@Controller
public class HomeController {
    private CustomerService customerService;
    private ProductService productService;

    // 第一个标记@Autowired的构造器，注入CustomerService
    @Autowired
    public HomeController(CustomerService customerService) {
        this.customerService = customerService;
    }

    // 第二个标记@Autowired的构造器，注入ProductService，直接触发构造器冲突
    @Autowired
    public HomeController(ProductService productService) {
        this.productService = productService;
    }
}

你可以任选以下两种标准写法修复，优先推荐第一种：

• 方案1（Spring 4.3及以上版本推荐，最简洁）：仅保留一个包含所有需要注入依赖的全参构造器，不需要显式添加@Autowired注解，Spring会自动识别类中唯一的构造器完成依赖注入：

@Controller
public class HomeController {
    private final CustomerService customerService;
    private final ProductService productService;

    // 唯一构造器，无需加@Autowired
    public HomeController(CustomerService customerService, ProductService productService) {
        this.customerService = customerService;
        this.productService = productService;
    }
}

• 方案2（兼容Spring 4.3以下低版本）：同样仅保留一个全参构造器，仅在这个构造器上添加@Autowired注解即可。如果业务需要保留其他重载构造器，禁止给其他构造器添加@Autowired(required = true)标记，特殊场景下可给非主构造器设置@Autowired(required = false)：

@Controller
public class HomeController {
    private final CustomerService customerService;
    private final ProductService productService;

    // 仅主构造器添加@Autowired
    @Autowired
    public HomeController(CustomerService customerService, ProductService productService) {
        this.customerService = customerService;
        this.productService = productService;
    }

    // 其他重载构造器示例，不能标记required=true的@Autowired
    public HomeController() {
        // 自定义无参逻辑
    }
}

Spring官方对构造器注入的判定逻辑：

1. 如果类中仅存在一个构造方法，无论是否添加@Autowired，Spring都会优先使用该构造器实例化Bean
2. 如果类中存在多个构造方法，必须精确指定1个构造器标记@Autowired(required = true)作为主注入构造器，其余构造器若添加@Autowired必须设置required = false，否则就会触发本次遇到的多构造器冲突异常
3. 类上标注@Transactional注解的Bean会被Spring自动创建AOP代理，不影响其作为依赖被注入到其他Bean中

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