2. 测试报告与日志基础

在自动化测试体系中，测试报告与测试日志是两类最基础、也最容易被混淆的产物。很多团队在搭建持续集成流水线时，只关注“用例是否通过”，却忽略了报告与日志的分工，导致失败原因难以定位、质量趋势无法量化。本节从基本概念出发，厘清术语、区别与联系，并给出自动化测试中的典型应用场景。

一、核心概念：报告是结论，日志是过程

测试报告（Test Report）是对一次或一段时间内测试执行结果的结构化汇总。它回答的是“测了什么、结果如何、是否达到准出标准”这类问题，通常包含用例总数、通过率、失败清单、耗时分布、覆盖率、缺陷关联等指标。报告面向的是决策者、测试负责人和研发团队，强调可读性与结论性。

测试日志（Test Log）是测试执行过程中由框架、被测系统、中间件、浏览器或设备产生的按时间顺序记录的事件流。它回答的是“执行到哪一步、发生了什么、为什么失败”这类问题，通常包含时间戳、日志级别、线程/进程、类名、请求响应、堆栈信息等。日志面向的是排障者和开发者，强调完整性与可追溯性。

二、常见术语速查

在阅读框架文档或设计报告字段前，先统一术语口径，可以避免团队沟通中的歧义。下表列出自动化测试中最常见的术语及其含义。

三、报告与日志的区别与联系

两者并非对立，而是同一执行过程的两个视角。下图展示了自动化测试执行时，报告与日志如何从同一批事件中分化出来，并最终在排障环节重新汇合。

从图中可以看出，报告与日志共享同一执行引擎产生的事件源，但输出形态和消费对象不同。报告中的一条失败记录，往往需要日志中的时间戳、请求报文和堆栈才能解释清楚；而日志中的海量事件，又需要报告来聚合出可读的结论。二者通过用例 ID、执行批次号、时间戳三个关键字段建立关联。

四、自动化测试中的典型应用场景

• 持续集成门禁：流水线每次构建后生成报告，若通过率低于阈值或存在阻塞级失败，则自动阻断合并。报告是门禁的判定依据。
• 失败用例快速定位：测试人员从报告点击失败用例，跳转到对应日志片段，查看断言失败前后的请求响应与堆栈，缩短平均修复时间。
• 稳定性与趋势分析：将多轮报告入库，统计用例的失败频次，识别“偶发失败”与“稳定失败”，为用例治理提供数据。
• 环境与数据问题排查：当大量用例同时失败时，日志中的连接超时、数据库锁等待等信息可快速判断是环境故障而非代码缺陷。
• 合规与审计留痕：金融、医疗等行业要求保留测试执行证据，报告与日志共同构成可追溯的审计材料。

五、实操示例：一次失败执行中报告与日志的配合

下面是一段典型的自动化测试日志片段，以及从报告中提取的对应失败记录。可以看到，报告给出结论，日志给出原因。

# 测试日志片段（log）
2024-06-11 10:23:41.882 INFO  [main] c.a.test.LoginTest - 开始执行: testLoginWithInvalidPassword
2024-06-11 10:23:42.105 INFO  [main] c.a.api.HttpClient - POST /api/login body={"user":"qa01","pwd":"wrong"}
2024-06-11 10:23:42.640 WARN  [main] c.a.api.HttpClient - 响应耗时 535ms, status=200
2024-06-11 10:23:42.642 ERROR [main] c.a.test.LoginTest - 断言失败: 期望 code=401, 实际 code=200
2024-06-11 10:23:42.643 ERROR [main] c.a.test.LoginTest - at LoginTest.testLoginWithInvalidPassword(LoginTest.java:58)

# 测试报告片段（report）
用例: testLoginWithInvalidPassword
状态: FAILED
耗时: 761ms
失败原因: AssertionError: expected 401 but was 200
关联日志: 2024-06-11 10:23:41.882 ~ 10:23:42.643

六、常见误区与复盘

复盘建议：在框架设计初期就约定报告字段规范与日志格式规范，统一用例 ID、批次号、时间戳的生成方式；报告负责“结论可读”，日志负责“过程可查”，两者通过唯一标识关联，才能让自动化测试的结果真正可消费、可决策、可追溯。