Android-Kotlin-JUnit 5环境下如何测试类的私有方法

方案1：使用 internal 修饰符（最小侵入生产代码） #

Kotlin 的 internal 修饰符限制成员仅在同一模块内可见，相比直接移除 private 不会破坏对外的封装性：

• 把原本需要设为 private 但需要测试的方法改为 internal 修饰
• Android 项目默认同一 module 的 src/test 源集和 src/main 源集属于同一模块，测试代码可以直接访问 internal 成员，不需要额外配置
• 外部模块无法访问你代码里的 internal 成员，封装性符合要求

方案2：通过反射调用私有方法（完全不修改生产代码） #

不需要改动生产代码的任何修饰符，直接在测试代码中用 Kotlin 反射 API 访问私有方法，示例代码如下：

import org.junit.jupiter.api.Test
import kotlin.reflect.full.declaredMemberFunctions
import kotlin.reflect.jvm.isAccessible

class YourTargetClassTest {
    @Test
    fun `测试私有方法逻辑`() {
        val targetInstance = YourTargetClass()
        // 查找目标私有方法
        val privateMethod = YourTargetClass::class.declaredMemberFunctions
            .first { it.name == "你的私有方法名" }
        // 授予访问权限
        privateMethod.isAccessible = true
        
        // 调用方法，传入实例和参数，强转返回值类型
        val result = privateMethod.call(targetInstance, 参数1, 参数2) as 返回值类型
        // 执行断言
        org.junit.jupiter.api.Assertions.assertEquals(预期值, result)
    }
}

注意：如果后续重构修改了私有方法的名称、参数列表，需要同步修改测试代码中的反射逻辑，否则测试会运行失败。

方案3：抽离内聚逻辑为独立组件 #

如果需要测试的多个私有方法逻辑内聚，可以将这部分代码抽离为独立的工具类/业务组件：

• 抽离后的组件可以根据需要设置为 internal 修饰，单独对组件编写测试用例
• 原有业务类仅保留对外暴露的1个公共方法，依赖抽离的组件实现逻辑，封装性完全不受影响

方案4：优先测试公开 API 行为 #

单元测试的核心原则是测试对外公开的行为而非内部实现细节：

• 你可以为唯一暴露的公共方法编写覆盖所有分支场景的测试用例，私有方法作为公共方法的实现逻辑，会被自动覆盖
• 如果私有方法逻辑复杂到需要单独测试，说明代码职责划分存在优化空间，建议参考方案3做逻辑抽离

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