SpringBoot是否基于变量名称进行Bean选择？无需@Qualifier可行吗？

最近研究Spring的Bean注入机制时，原本预期在存在两个同类型Bean的情况下应用启动失败，但实际应用却正常运行，具体场景如下：

代码结构 #

接口定义 #

public interface Demo {
  String getMessage();
}

两个实现类 #

@Service
public class DemoService implements Demo{
  private final DataRepo repo;

  DemoService(DataRepo repo) {
    this.repo = repo;
  }

  @Override
  public String getMessage() {
    return "Demo message from Demo Service";
  }
}

@Service
public class DemoSecondService implements Demo{
  private final DataRepo repo;

  DemoSecondService(DataRepo repo) {
    this.repo = repo;
  }

  @Override
  public String getMessage() {
    return "Demo message from DemoSecondService";
  }
}

控制器类 #

@RestController
@RequestMapping("/demo")
public class DemoController {
  private final Demo demoSecondService; //(1)

  public DemoController(Demo demoSecondService) {
    this.demoSecondService = demoSecondService;
  }

  @GetMapping
  ResponseEntity<String> hello() {
    return new ResponseEntity<>("Hello", HttpStatus.OK);
  }

  @GetMapping("/more")
  ResponseEntity<String> moreHello() {
    String message = demoSecondService.getMessage();
    return new ResponseEntity<>(message, HttpStatus.OK);
  }
}

观察到的现象 #

• 当控制器中的Demo变量名为demoSecondService时，Spring自动注入DemoSecondService Bean；变量名为demoService时，注入DemoService Bean；
• 甚至变量名为demoSecondServiceXXXXX时也能成功注入；
• 但当变量名改为与类名完全无关的newName时，Spring抛出异常：

Parameter 0 of constructor in com.example.demo.domain.controller.DemoController required a single bean, but 2 were found:
    - demoSecondService: defined in file 
    - demoService: defined in file 

疑问：为何变量名称与Bean名称匹配时Spring能注入对应Bean？SpringBoot是否会基于变量名称进行Bean选择，无需@Qualifier注解？

这是Spring核心容器的**按名称自动注入（Autowire by Name）**特性，并非SpringBoot独有，具体逻辑如下：

1. Bean名称的默认生成规则
   使用@Service、@Component等注解声明的Bean，默认会将类名首字母小写作为Bean的名称：

   • DemoService类对应的Bean名称为demoService
   • DemoSecondService类对应的Bean名称为demoSecondService

2. 多同类型Bean的注入匹配逻辑
   当Spring需要注入一个依赖，且存在多个同类型的Bean时，会优先执行以下逻辑：

   • 检查注入点的参数名/字段名是否与某个Bean的名称完全匹配；
   • 如果找到完全匹配的Bean，直接注入该Bean，无需额外添加@Qualifier注解；
   • 如果没有找到完全匹配的名称，Spring无法确定要注入的Bean，才会抛出“存在多个匹配Bean”的异常。

3. 关于“变量名为demoSecondServiceXXXXX也能生效”的说明
   Spring的按名称匹配是完全匹配逻辑，不会做前缀模糊匹配，这种情况大概率是测试中的误差。建议你仔细检查：

   • 是否手动指定过Bean名称（比如@Service("demoSecondServiceXXXXX")）；
   • 变量名是否与某个Bean的名称实际完全一致；
   • 项目中是否存在自定义的Bean名称生成逻辑。

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