在Spring Boot项目的单元测试编写过程中，服务层未被调用是开发者经常遇到的问题，这会导致测试无法覆盖核心业务逻辑，无法验证代码的正确性。这种问题通常由配置或逻辑编写不当导致，需要逐一排查。
常见原因分析
1. 测试类注解配置错误
如果测试类没有使用正确的Spring Boot测试注解，容器不会加载对应的Bean，自然无法调用服务层。比如仅使用@Test注解而没有搭配@SpringBootTest，或者错误使用@ExtendWith(MockitoExtension.class)时未正确注入依赖，都会导致服务层Bean不存在。
2. Mock对象未正确设置行为
当使用@MockBean模拟依赖时，如果没有设置模拟对象的方法返回值，或者错误模拟了服务层本身，会导致调用时直接返回默认值，看起来像是服务层没有被调用。比如误将服务层对象声明为@MockBean而不是@Autowired注入真实对象。
3. 测试逻辑未触发服务层调用
部分开发者编写测试时，仅初始化了对象但没有执行调用服务层方法的逻辑，或者调用的入口方法本身没有关联服务层，导致服务层方法始终没有被执行。
4. 事务或测试上下文配置问题
如果测试类配置了特殊的事务管理或者自定义测试上下文，可能导致服务层Bean没有被正确加载到测试容器中，进而无法被调用。
正确配置方案
1. 正确配置测试类注解
对于需要加载Spring上下文的单元测试，测试类需要添加@SpringBootTest注解，如果需要结合Mockito使用，可以搭配@ExtendWith(MockitoExtension.class)，确保容器正确加载Bean。
示例测试类注解配置：
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.test.context.junit.jupiter.SpringExtension;
// 正确注解配置，加载Spring上下文并支持Mockito
@SpringBootTest
@ExtendWith(SpringExtension.class)
public class UserServiceTest {
// 注入真实的服务层对象
@Autowired
private UserService userService;
// 模拟服务层依赖的Mapper层对象
@MockBean
private UserMapper userMapper;
@Test
public void testGetUserById() {
// 测试逻辑
}
}
2. 正确区分Mock对象和真实对象
服务层本身如果是测试的核心对象，需要通过@Autowired注入真实对象，仅对其依赖的下游组件（如Mapper、外部接口客户端）使用@MockBean模拟。同时需要为模拟对象设置正确的行为，避免调用时返回默认值。
模拟对象行为设置示例：
import static org.mockito.Mockito.when;
@Test
public void testGetUserById() {
// 模拟userMapper的selectById方法返回预期结果
User mockUser = new User();
mockUser.setId(1L);
mockUser.setName("测试用户");
when(userMapper.selectById(1L)).thenReturn(mockUser);
// 调用服务层方法，此时服务层会被正常触发
User result = userService.getUserById(1L);
// 断言验证
assert result != null;
assert "测试用户".equals(result.getName());
}
3. 完善测试逻辑触发调用
编写测试时，需要明确调用链路，确保测试方法中执行了调用服务层方法的逻辑，避免仅做初始化操作。同时可以通过Mockito的verify方法验证服务层方法是否被执行。
验证服务层调用示例：
import static org.mockito.Mockito.verify;
@Test
public void testUpdateUser() {
User user = new User();
user.setId(1L);
user.setName("更新后的名称");
// 调用服务层方法
userService.updateUser(user);
// 验证userMapper的updateById方法被调用，间接验证服务层逻辑执行
verify(userMapper).updateById(user);
}
4. 检查测试上下文配置
如果自定义了测试配置类，需要确保配置类没有被@SpringBootTest的classes属性错误排除，同时避免在测试类中添加不必要的@MockBean导致真实的服务层Bean被覆盖。
问题排查步骤
当遇到服务层未被调用的问题时，可以按照以下步骤排查：
- 检查测试类是否添加了
@SpringBootTest注解，确保Spring上下文正确加载 - 检查服务层对象是通过
@Autowired注入还是被错误声明为@MockBean - 检查测试方法中是否实际调用了服务层的方法，没有遗漏调用逻辑
- 使用
verify方法验证依赖对象的方法是否被调用，确认调用链路是否通畅 - 检查是否有自定义的测试配置影响了Bean的加载
注意事项
编写单元测试时，不要过度模拟，服务层作为核心业务逻辑层，应当尽量测试真实的逻辑，仅模拟其下游不确定的依赖。同时测试方法的命名要清晰，明确测试的场景，方便后续排查问题。如果使用的是JUnit4，需要将@ExtendWith替换为@RunWith(SpringRunner.class)，注解的使用要和JUnit版本匹配。
Spring_Boot单元测试服务层@MockBean@Autowired修改时间：2026-07-03 01:12:28