跨平台开发 / 系统课时
找出高风险未覆盖分支
找出高风险未覆盖分支
覆盖率下降并不意味着风险一定高,覆盖率很好也不代表关键分支已经验证。本节从未覆盖行出发,结合错误处理、状态转换和边界条件筛出真正需要优先补测的分支。
学习目标
- 区分“覆盖率低”和“业务风险高”这两个不同问题
- 从条件判断、异常路径和状态转换中识别高风险未覆盖分支
- 用针对性测试验证关键失败路径,而不是机械追求百分比
先按失败影响看分支
阅读未覆盖代码时,先问“这条分支走错会造成什么后果”。通常应优先检查权限与鉴权、金额计算、不可逆状态转换、外部副作用、重试与异常恢复,以及空值、上下界和重复请求等边界。
| 分支类型 | 典型后果 | 测试优先级判断 |
|---|---|---|
| 错误处理 | 异常被吞掉、错误状态继续执行 | 看是否会掩盖故障或产生错误副作用 |
| 状态转换 | 非法状态进入后续流程 | 看状态是否不可逆、是否影响订单或任务 |
| 边界判断 | 越界、重复处理、空输入 | 看边界是否来自真实外部输入 |
| 普通展示逻辑 | 文案或格式差异 | 通常低于资金、权限和持久化路径 |
这个顺序不是固定评分表,而是帮助你先把测试时间投入到失败代价更高的地方。
从代码中找真正的分支
下面的完整示例包含订单状态转换。先在 Dart package 根目录准备测试与覆盖率开发依赖。
dart pub add dev:test dev:coverage >/dev/null && echo "test dependencies ready"预期输出:
test dependencies ready将实现保存为 lib/order_transition.dart。正常支付和发货路径很容易覆盖,但终态保护、未支付发货和取消路径同样需要检查。
enum OrderState { created, paid, shipped, cancelled }
enum OrderEvent { pay, ship, cancel }
OrderState transition(OrderState state, OrderEvent event) {
// 已发货或已取消属于终态,禁止再次转换。
if (state == OrderState.shipped || state == OrderState.cancelled) {
throw StateError('terminal order cannot transition');
}
if (event == OrderEvent.pay) {
if (state != OrderState.created) {
throw StateError('only created order can be paid');
}
return OrderState.paid;
}
if (event == OrderEvent.ship) {
if (state != OrderState.paid) {
throw StateError('only paid order can be shipped');
}
return OrderState.shipped;
}
return OrderState.cancelled;
}先写只有快乐路径的测试,保存为 test/order_transition_test.dart。
import 'package:test/test.dart';
import '../lib/order_transition.dart';
void main() {
test('created order can be paid', () {
expect(
transition(OrderState.created, OrderEvent.pay),
OrderState.paid,
);
});
test('paid order can be shipped', () {
expect(
transition(OrderState.paid, OrderEvent.ship),
OrderState.shipped,
);
});
}运行测试:
dart test >/dev/null && echo "happy-path tests passed"预期输出:
happy-path tests passed这两条测试证明主流程可走通,却没有验证“已取消订单再次支付”“未支付订单直接发货”和取消结果。生成 LCOV 后,可以先把零命中行列出来作为审查入口。
dart run coverage:test_with_coverage >/dev/null && awk -F'[:,]' '/^SF:/{file=substr($0,4)} /^DA:[0-9]+,0(,|$)/{print file ":" $2}' coverage/lcov.info预期结果(存在未覆盖行时):
<PATH>:<LINE>
<PATH>:<LINE><PATH> 和 <LINE> 会随实际文件位置与源码行号变化。零命中只说明代码没有执行,不能直接代表风险等级。
把未覆盖行转换成测试问题
看到一个零命中行时,不要直接写“覆盖这一行”的测试,而要把它翻译成可验证的业务问题。例如:
- 终态保护未覆盖:已取消或已发货的订单还能不能再次改变状态?
- 未支付发货分支未覆盖:系统是否明确拒绝非法操作?
- 取消返回值未覆盖:取消事件是否真的进入
cancelled状态?
这种写法能避免为了触发行而构造没有断言价值的测试。测试的目标是验证行为契约,覆盖率只是发现空白的入口。
补上高风险失败路径
把测试文件扩充为下面的完整版本。除了正常路径,还明确断言非法转换会抛出 StateError,并验证取消状态。
import 'package:test/test.dart';
import '../lib/order_transition.dart';
void main() {
test('created order can be paid', () {
expect(
transition(OrderState.created, OrderEvent.pay),
OrderState.paid,
);
});
test('paid order can be shipped', () {
expect(
transition(OrderState.paid, OrderEvent.ship),
OrderState.shipped,
);
});
test('created order cannot be shipped', () {
expect(
() => transition(OrderState.created, OrderEvent.ship),
throwsStateError,
);
});
test('cancelled order is terminal', () {
expect(
() => transition(OrderState.cancelled, OrderEvent.pay),
throwsStateError,
);
});
test('created order can be cancelled', () {
expect(
transition(OrderState.created, OrderEvent.cancel),
OrderState.cancelled,
);
});
}再次执行:
dart test >/dev/null && echo "risk-focused tests passed"预期输出:
risk-focused tests passed如果新增测试只让总覆盖率提高很少,也不代表收益很小。覆盖一个“禁止未支付发货”的分支,往往比覆盖十行低风险格式化代码更重要。最终应把覆盖率报告与失败影响一起阅读:先用报告找空白,再用业务风险决定补测顺序。