Spring Boot JUnit测试：如何Mock包私有实现类的UserService接口？

问题背景 #

测试UserService时遇到两个核心问题：

1. 用@InjectMocks注入UserService接口时，Mockito报错无法实例化接口类型
2. 改用@Mock标注UserService后，调用saveUser返回null触发空指针

根本原因：实现类UserServiceImpl是包私有，测试类无法直接访问；Mockito的@InjectMocks需要具体实例支撑，而@Mock只会生成空实现的代理，不会执行真实业务逻辑。

解决方案 #

方案1：调整测试类包路径，与实现类同包

将测试类从com.company移至com.company.service.impl（和UserServiceImpl同包），这样就能直接引用包私有的UserServiceImpl，再用@InjectMocks自动注入依赖：

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

    @Mock
    private UserRepository userRepository;

    @InjectMocks
    private UserServiceImpl userService; // 直接使用实现类，同包可访问

    @Test
    void shouldCreateUser() {
        SignUpRequest signUpRequest = new SignUpRequest();
        signUpRequest.setUsername("test_user");
        signUpRequest.setFirstName("Test");

        User mockUser = new User();
        when(userRepository.save(any(User.class))).thenReturn(mockUser);

        UserDTO savedUserDTO = userService.saveUser(signUpRequest);

        assertNotNull(savedUserDTO);
        assertEquals("test_user", savedUserDTO.getUsername());
    }
}

优点：代码简洁，符合测试类与目标类同包的规范，无需额外复杂操作。

方案2：通过反射实例化包私有实现类

如果不想调整测试包路径，用反射绕过包私有访问限制，手动实例化UserServiceImpl：

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

    @Mock
    private UserRepository userRepository;

    private UserService userService;

    @BeforeEach
    void setUp() throws NoSuchMethodException, InstantiationException, IllegalAccessException {
        // 获取@RequiredArgsConstructor生成的带参构造方法
        Constructor<UserServiceImpl> constructor = UserServiceImpl.class.getDeclaredConstructor(UserRepository.class);
        constructor.setAccessible(true); // 开启私有构造的访问权限
        userService = constructor.newInstance(userRepository);
    }

    @Test
    void shouldCreateUser() {
        // 测试逻辑同方案1
    }
}

优点：无需修改测试类包路径；缺点：依赖反射，代码略繁琐，若实现类构造方法变更需同步修改。

方案3：使用Spring Boot Test注入Service实例

如果是Spring Boot项目，利用Spring容器管理的Bean来获取UserService实例，Spring可以正常扫描并管理包私有的@Service类：

@SpringBootTest
class UserServiceTest {

    @Autowired
    private UserService userService;

    @MockBean
    private UserRepository userRepository; // 替换容器中的真实Repository为Mock

    @Test
    void shouldCreateUser() {
        SignUpRequest signUpRequest = new SignUpRequest();
        signUpRequest.setUsername("test_user");
        signUpRequest.setFirstName("Test");

        User mockUser = new User();
        when(userRepository.save(any(User.class))).thenReturn(mockUser);

        UserDTO savedUserDTO = userService.saveUser(signUpRequest);

        assertNotNull(savedUserDTO);
        assertEquals("test_user", savedUserDTO.getUsername());
    }
}

优点：适合集成测试，能模拟更真实的环境；缺点：启动Spring容器会增加测试耗时。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu