Bazel test 怎么只显示失败测试的日志

在 Bazel 项目中运行大量测试时，成功用例的输出往往会淹没真正需要排查的失败信息。要只保留失败测试的日志，可以在 bazel test 后加入 --test_output=errors。它调整的是测试输出级别，不会修改测试规则；通过的目标保持简洁，失败目标仍会保留用于排障的错误输出。

官方地址：https://bazel.build/reference/command-line-reference

最小命令是 bazel test --test_output=errors //path/to:target。运行结束后重点看失败目标、失败日志位置和非零退出状态；不要把“没有成功日志”误认为测试没有执行。

先确定输出级别与排障目标

Bazel 的测试输出级别决定终端中展示多少测试进程的日志。这个选项与测试目标、断言和规则实现是两层事情：本次只调整“输出什么”，不改 BUILD 文件，也不改变测试是否通过。

如果目标是让 CI 日志保持可读，同时在失败时留下可用上下文，优先选择 errors。它不是“只打印一行失败名称”，而是保留失败测试进程产生的错误信息。

在 Bazel test 命令中设置 errors

进入 Bazel 项目根目录后，在测试命令中直接加入参数。下面的目标名只是示例，请替换成项目里实际存在的测试目标。

# 在 Bazel 项目根目录运行指定测试；errors 只展开失败测试日志
bazel test --test_output=errors //app/handler:handler_test

# 运行一个包下的测试目标；成功目标保持简洁，失败目标保留错误上下文
bazel test --test_output=errors //app/handler:all

# 临时调试时改成 all，查看全部测试输出；排查完成后可恢复 errors
bazel test --test_output=all //app/handler:handler_test

参数的位置可以放在 bazel test 后、目标模式前。为了避免团队成员每次手动记忆，可以把它放入测试脚本的参数数组或 CI 的测试入口；不要把它写进单个测试规则的源码里。

操作路径可以固定成：项目根目录 → 测试命令入口 → 输出级别参数 → 测试目标。完成后先观察终端是否出现测试汇总，再进入失败目标的日志查看区。

在结果界面中定位失败日志

运行结束后，先按目标状态区分成功和失败，再展开失败目标。原创界面说明图中的“FAILED”“stderr”和“exit code”分别对应失败状态、错误输出区域和进程退出结果，实际项目中的布局可能不同，但核对顺序相同。

1. 在测试结果列表中找到状态为 FAILED 的目标，记录完整目标标签。
2. 打开该目标的日志或结果详情，优先查看标准错误、断言信息和测试进程退出原因。
3. 确认终端命令以非零状态结束；这说明失败被保留，而不是因为输出被隐藏就变成成功。
4. 把失败目标、关键日志位置和复现命令一并记录，方便后续单独重跑。

# 只重跑已经失败的目标，缩小下一次排查范围
bazel test --test_output=errors //app/handler:handler_test

# 将命令和退出状态交给脚本；失败时保留原始错误码
bazel test --test_output=errors //app/handler:handler_test
status=$?
# 用中文注释说明失败分支，避免 CI 把错误吞掉
if [ "$status" -ne 0 ]; then
  echo "测试失败，请查看上方失败目标日志" >&2
  exit "$status"
fi

处理缓存、并行和需要更多上下文的情况

看不到日志时，不要立即判断参数失效。首先检查目标是否命中缓存：缓存命中可能不会重新启动测试进程，因此也不会产生新的进程日志。其次确认测试目标确实失败；errors 不会为成功测试制造一份错误日志。

• 只想确认参数：先用一个已知会失败的测试目标观察输出，再恢复正常测试。
• 怀疑缓存影响：在明确需要重新执行时，临时使用项目允许的缓存清理或禁用缓存方案，并记录这是一次排查动作。
• 失败日志过短：只对单个目标临时切换 --test_output=all，不要长期让整批 CI 输出膨胀。
• 并行输出难读：先保留失败目标清单，再单独重跑目标，避免把多进程交错输出当成一条完整堆栈。

这些处理都围绕“输出展示”展开。不要为了让日志出现而修改测试断言、删除失败用例或把失败命令包在总是返回成功的脚本中。

归档可复用的命令配置

本地开发和 CI 可以采用不同输出级别：日常批量运行使用 errors，需要追踪单个测试时临时改成 all。建议把命令、目标模式和结果记录字段放在同一份脚本说明里。

这样归档后，读者看到的不只是“命令加了一个参数”，还知道什么时候该放大日志、如何核对失败、以及怎样把单个目标交给下一轮排查。

常见问题

--test_output=errors 会让成功测试不执行吗？

不会。它只控制测试输出展示；成功目标仍会参与本次测试，终端主要显示汇总信息。

为什么失败了却没有完整日志？

先检查是否命中缓存、失败目标是否产生了可输出内容，以及是否需要对单个目标临时使用 --test_output=all。不要只根据终端的简短汇总判断日志不存在。

可以把参数写进 BUILD 文件吗？

这个参数属于 Bazel 命令行测试输出设置，通常应放在测试脚本、CI 入口或个人命令别名中，而不是混入某个测试规则的属性。

本地和 CI 应该使用同一个输出级别吗？

不一定。批量 CI 常用 errors 控制日志体积，本地深度排查可以临时使用 all；关键是把失败目标和复现命令记录下来。

记住这条最小路径：bazel test --test_output=errors 目标。先用它降低成功测试的噪声，再从失败目标进入日志详情，核对状态、错误输出和退出码；只有需要更多上下文时，才对单个目标临时放大到 all。