Spring单元测试如何Mock注入的组件Map解决依赖不满足报错

结论 #

你完全可以Mock这个自动注入的Map，出现unsatisfied dependency报错的核心原因是你定义的Mock对象没有被注册到测试阶段的依赖容器中，Spring在注入业务类时找不到匹配的Map类型Bean，和Spring自动收集接口实现组装Map的原生机制无关。

Spring原生支持同类型多实现的自动收集：当你注入Map<String, 接口类型>时，容器会自动把所有该接口的实现类组装成Map，key为Bean的名称，value为对应实现实例，你代码里的注入逻辑本身是符合Spring规范的。

额外提示：不要在@Configuration类上叠加@Component注解，@Configuration本身已经是Spring可识别的组件注解，重复标注在部分旧版本Spring中可能引发Bean重复加载的问题。

根据你写的单元测试类型，选对应方案即可：

方案1：启动Spring测试上下文的集成测试（使用@SpringBootTest/@ContextConfiguration） #

这类测试会走完整的Spring依赖注入流程，推荐两种写法：

• 直接Mock整个Map对象：用@MockBean注解声明你要Mock的Map，Spring会自动把这个Mock对象注册到测试容器，替换掉原本自动组装的真实Map，不会再出现依赖找不到的问题
  示例代码：

  @SpringBootTest
  public class BusinessServiceTest {
      // 声明Mock Map，优先级高于容器自动组装的真实Map
      @MockBean
      private Map<String, MyInterface> myInterfaceMockMap;
  
      @Autowired
      private BusinessService businessService;
  
      @Test
      void testBizLogic() {
          // 按测试需求给Mock Map打桩
          MyInterface testImpl = Mockito.mock(MyInterface.class);
          Mockito.when(myInterfaceMockMap.get("class1")).thenReturn(testImpl);
          // 执行测试逻辑、加断言即可
      }
  }
  

• 只Mock部分实现类：如果你不需要替换整个Map，只是想让部分实现返回Mock逻辑，不需要单独处理Map注入，直接用@MockBean标注你要替换的MyInterface实现类即可，Spring组装Map时会自动把Mock后的实现放入Map中。

方案2：不启动Spring上下文的纯单元测试 #

这类测试不需要走Spring的依赖注入流程，完全不会出现容器找不到依赖的问题：你可以自己组装测试用的Map，通过业务类的构造方法、Setter方法或者反射工具，直接把组装好的Map传入业务类实例即可。
示例代码：

public class BusinessServiceTest {
    @Mock
    private MyInterface class1Mock;
    @Mock
    private MyInterface class2Mock;

    private BusinessService businessService;

    @BeforeEach
    void setUp() {
        // 初始化Mock注解
        MockitoAnnotations.openMocks(this);
        // 自行组装测试用的Map，只放入你测试需要的实现
        Map<String, MyInterface> testMap = new HashMap<>();
        testMap.put("class1", class1Mock);
        testMap.put("class2", class2Mock);
        // 直接注入到业务类实例，优先走构造方法注入，没有构造方法可以用反射设置字段值
        businessService = new BusinessService(testMap);
    }

    @Test
    void testBizLogic() {
        // 给Mock对象打桩、执行测试逻辑、加断言即可
    }
}

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