如何为注入Mock类的私有void方法编写测试或排除Sonar覆盖率

方案一：将特定私有方法从Sonar覆盖率中排除 #

1. 通过构建工具配置 #

Maven 示例

在pom.xml的sonar-maven-plugin中添加精准的覆盖排除规则：

<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.9.1.2184</version>
    <configuration>
        <!-- 格式：文件路径#方法完整签名（含参数类型） -->
        <sonar.coverage.exclusions>
            **/com/example/YourClass.java#yourPrivateVoidMethod(java.lang.String)
        </sonar.coverage.exclusions>
    </configuration>
</plugin>

Gradle 示例

在build.gradle中配置Sonar属性：

sonar {
    properties {
        property "sonar.coverage.exclusions", "**/com/example/YourClass.java#yourPrivateVoidMethod(java.lang.String)"
    }
}

2. 通过SonarQube界面配置 #

进入项目的「设置」→「覆盖率」→「排除项」，添加方法匹配规则，格式为文件相对路径#方法完整签名，例如：
com/example/YourClass.java#doInternalProcessing(java.util.List)

方案二：为私有Void方法编写测试用例 #

1. 使用Java反射直接调用 #

通过反射绕过访问权限限制，调用私有方法并验证副作用（如依赖方法调用、对象状态变化）：

import org.junit.jupiter.api.Test;
import org.mockito.Mock;
import org.mockito.MockitoAnnotations;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import static org.mockito.Mockito.verify;

class YourClassTest {

    @Mock
    private YourDependency mockDependency;

    @Test
    void testPrivateVoidMethod() throws Exception {
        // 初始化Mock并手动注入依赖（解决@InjectMocks失效问题）
        MockitoAnnotations.openMocks(this);
        YourClass target = new YourClass();
        
        Field dependencyField = YourClass.class.getDeclaredField("yourDependency");
        dependencyField.setAccessible(true);
        dependencyField.set(target, mockDependency);

        // 获取并调用私有方法
        Method privateMethod = YourClass.class.getDeclaredMethod("yourPrivateVoidMethod", String.class);
        privateMethod.setAccessible(true);
        privateMethod.invoke(target, "测试参数");

        // 验证依赖方法是否被正确调用
        verify(mockDependency).processData("测试参数");
    }
}

2. 使用PowerMock简化私有方法调用 #

PowerMock可以直接处理私有方法调用，同时兼容Mockito的Mock注入：

第一步：添加Maven依赖

<dependency>
    <groupId>org.powermock</groupId>
    <artifactId>powermock-module-junit4</artifactId>
    <version>2.0.9</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.powermock</groupId>
    <artifactId>powermock-api-mockito2</artifactId>
    <version>2.0.9</version>
    <scope>test</scope>
</dependency>

第二步：编写测试用例

import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.powermock.api.mockito.PowerMockito;
import org.powermock.core.classloader.annotations.PrepareForTest;
import org.powermock.modules.junit4.PowerMockRunner;
import static org.mockito.Mockito.verify;

@RunWith(PowerMockRunner.class)
@PrepareForTest(YourClass.class)
public class YourClassTest {

    @InjectMocks
    private YourClass target;

    @Mock
    private YourDependency mockDependency;

    @Test
    void testPrivateVoidMethod() throws Exception {
        // 直接调用私有方法
        PowerMockito.invokePrivateMethod(target, "yourPrivateVoidMethod", "测试参数");

        // 验证依赖方法调用
        verify(mockDependency).expectedMethod("测试参数");
    }
}

注：如果使用JUnit 5，替换@RunWith(PowerMockRunner.class)为@ExtendWith(PowerMockExtension.class)。@InjectMocks失效通常是因为依赖注入方式（如构造函数注入未被正确识别）或未初始化Mock上下文，确保添加MockitoAnnotations.openMocks(this)或对应的Runner/Extension。

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