Testing Legacy Strategies (遗留代码测试)

Instructions

仅在缺乏测试的既有代码上使用
先填写 Required Inputs（高风险路径、测试栈、阻挡策略）
依照下方章节顺序创建安全网
一次只锁定一类行为或输出
完成后对照 Quick Checklist

When to Use

Scenario C：旧项目现代化前的安全网
Scenario F：共享逻辑需要测试保障

Example Prompts

"请依照 Characterization Tests 章节，替这个类别创建现状测试"
"用 Robolectric 章节，为依赖 Framework 的 Activity 写测试"
"请用 Detekt/Lint Baseline 章节创建技术债控管"

Workflow

先确认 Required Inputs（风险路径、测试优先级、CI 门槛）
创建 Characterization Tests 锁定行为
补齐 Framework 测试与 MockK 策略
建立 Baseline 与 CI 门禁，避免技术债回流
执行 Legacy Test Gate 并用 Quick Checklist 验收

Practical Notes (2026)

测试输出必须可重复与可比对
每次只锁定一类行为，避免测试爆量
Baseline 逐步收敛，避免一次性大改
先覆盖高风险业务，再扩展到普通路径
flaky case 必须标记 owner 与修复截止时间

Environment & Compatibility (先确认)

在开始前先记录测试栈：AGP / Kotlin / JUnit4 or JUnit5 / Robolectric / MockK / kotlinx-coroutines-test
同一模块避免混搭两套测试 runner；若必须混搭，先确认执行入口与依赖冲突
Robolectric 版本需与项目 compileSdk 与 AGP 组合先做 smoke test
所有示例版本号以项目 libs.versions.toml 或既有依赖锁定为准
若版本未定，请先完成 1 个最小可执行测试再批量铺开

Minimal Template

目标: 
测试范围: 
高风险路径:
CI 阻挡门槛:
行为锁定: 
回归方式: 
验收: Quick Checklist

Required Inputs (执行前输入)

高风险路径（金流/登录/权限/写入）
测试栈版本（JUnit/MockK/Robolectric/coroutines-test）
CI 阻挡策略（哪些失败阻挡合并）
Baseline 策略（是否允许、收敛计划）
责任人（测试 owner）

Deliverables (完成后交付物)

Characterization tests 列表
Framework 相关测试（Robolectric/Instrumented）
Baseline 文件与收敛计划
CI 测试门禁 配置
Legacy Test Gate 验收记录

Legacy Test Gate (验收门槛)

./gradlew test
./gradlew connectedDebugAndroidTest

PR 需要说明新增测试覆盖了哪些高风险行为。

Characterization Tests (现状测试)

为没有测试的旧代码撰写「现状测试」，不管对错，先锁定行为。

样本选择顺序 (避免盲目铺量)

先测高风险路径：金流、登录、权限、数据写入
再测边界条件：null、空集合、最小/最大值、异常输入
最后补常见主路径：最常被调用的 20% 场景
每轮只新增一类行为，确保失败原因单一可诊断

策略

// 1. 先写一个会失败的测试
@Test
fun `calculateDiscount returns unknown value`() {
    val result = legacyCalculator.calculateDiscount(100.0, "VIP")
    assertEquals(0.0, result)  // 故意用错误的预期值
}

// 2. 运行测试，记录实际回传值
// AssertionError: expected 0.0 but was 15.0

// 3. 更新测试为实际值
@Test
fun `calculateDiscount returns 15 percent for VIP`() {
    val result = legacyCalculator.calculateDiscount(100.0, "VIP")
    assertEquals(15.0, result)  // 锁定现有行为
}

批量生成

@ParameterizedTest
@CsvSource(
    "100.0, VIP, 15.0",
    "100.0, REGULAR, 5.0",
    "50.0, VIP, 7.5"
)
fun `calculateDiscount characterization`(
    price: Double,
    tier: String,
    expected: Double
) {
    assertEquals(expected, legacyCalculator.calculateDiscount(price, tier))
}

Robolectric (Android Framework 测试)

处理高度依赖 Android Framework 的旧单元测试。

设置

// build.gradle.kts
testImplementation("org.robolectric:robolectric:<project-verified-version>")

// 测试类别
@RunWith(RobolectricTestRunner::class)
@Config(sdk = [33])
class LegacyActivityTest {
    private lateinit var activity: LegacyActivity

    @Before
    fun setUp() {
        activity = Robolectric.buildActivity(LegacyActivity::class.java)
            .setup()
            .get()
    }
    
    @Test
    fun `activity displays correct title`() {
        assertEquals("Expected Title", activity.title)
    }
}

Shadow 使用

@Test
fun `shows toast on error`() {
    activity.showError("Network failed")
    
    assertEquals("Network failed", ShadowToast.getTextOfLatestToast())
}

MockK for Kotlin

基本用法

@Test
fun `repository returns cached data`() {
    val repository = mockk<UserRepository>()
    every { repository.getUser("123") } returns User(id = "123", name = "Test")
    
    val result = repository.getUser("123")
    
    assertEquals("Test", result.name)
    verify { repository.getUser("123") }
}

Coroutines Support

@Test
fun `suspend function mocking`() = runTest {
    val api = mockk<UserApi>()
    coEvery { api.fetchUser("123") } returns User(id = "123", name = "Test")
    
    val result = api.fetchUser("123")
    
    assertEquals("123", result.id)
    assertEquals("Test", result.name)
    coVerify(exactly = 1) { api.fetchUser("123") }
}

Dispatcher 控制 (降低 flaky)

@OptIn(ExperimentalCoroutinesApi::class)
class MainDispatcherRule(
    private val dispatcher: TestDispatcher = UnconfinedTestDispatcher()
) : TestWatcher() {
    override fun starting(description: Description) {
        Dispatchers.setMain(dispatcher)
    }

    override fun finished(description: Description) {
        Dispatchers.resetMain()
    }
}

Relaxed Mocks

// 自动回传默认值，适合旧代码测试
val service = mockk<LegacyService>(relaxed = true)

Detekt/Lint Baseline

渐进式收紧旧项目的品质标准。

生成 Baseline

# Detekt
./gradlew detektBaseline
# 产生 config/detekt/baseline.xml

# Lint
./gradlew lintDebug -Dlint.baselines.continue=true
# 产生 lint-baseline.xml

只检查新代码

// build.gradle.kts
android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

detekt {
    baseline = file("config/detekt/baseline.xml")
}

渐进式修复

# 每个 Sprint 减少 Baseline 中的项目
# 1. 修复一批问题
# 2. 重新生成 Baseline
./gradlew detektBaseline

CI 门禁 (防止回流)

# PR 常规检查：不允许新增违规
./gradlew detekt lintDebug

# 建议策略：
# 1. Baseline 文件只允许在「技术债收敛任务」中变更
# 2. 业务 PR 若修改 baseline，需额外说明与审批

Golden Master Testing

适合复杂输出 (HTML, JSON) 的旧代码。

@Test
fun `report generator produces expected output`() {
    val output = legacyReportGenerator.generate(testData)
    
    // 首次运行：保存为 golden file
    // File("src/test/resources/golden/report.html").writeText(output)
    
    // 后续运行：比对
    val golden = File("src/test/resources/golden/report.html").readText()
    assertEquals(golden, output)
}

实务建议：

先做标准化再比对（时间、时区、随机值、UUID、排序）
Golden 文件纳入版本控制并在 PR 中审阅 diff
输出过大时改用结构化断言 + 关键片段 golden，降低维护成本