Rust / 系统课时
为随机输入设置可复现种子
为随机输入设置可复现种子
随机测试最大的价值是探索未知输入,最大的工程痛点则是“刚才失败的输入怎么再跑一次”。proptest 支持通过 RNG seed 固定随机源;配合失败持久化机制,团队可以把一次偶发失败稳定重放,用于本地调试和 CI 回归。
学习目标
- 理解随机种子与测试可复现之间的关系
- 会使用
PROPTEST_RNG_SEED固定 proptest 的随机源 - 能区分固定种子重放与失败案例持久化的用途
种子为什么能影响复现
proptest 的测试运行器使用随机数生成器决定策略产生哪些输入。当前版本提供 rng_seed 配置字段,并支持通过环境变量 PROPTEST_RNG_SEED 设置种子;未指定时则会生成随机种子。固定相同种子可以让相同测试配置下的随机生成过程获得稳定的起点。([Docs.rs][1])
需要注意,seed 固定的是随机生成过程,不等于“任何未来版本、任何实现变更都永远产生完全相同的测试过程”。策略、测试配置、RNG 算法或被测逻辑发生变化,都可能改变最终行为。

用环境变量固定一次测试
最简单的工程用法是不改源码,在运行测试时设置 PROPTEST_RNG_SEED。下面的命令直接作用于 cargo test。
PROPTEST_RNG_SEED=123 cargo test --test properties normalize_is_idempotent预期结果
running 1 test
test normalize_is_idempotent ... ok
test result: ok. 1 passed; 0 failed再次使用相同命令,测试会从相同的 seed 起点开始。若测试配置和代码保持不变,这对重现某次随机探索路径很有帮助。当前 proptest 文档明确说明,PROPTEST_RNG_SEED 用于设置 RNG seed;若环境变量未定义,则默认生成随机 seed。([Docs.rs][1])
在 CI 中也可以显式记录实际使用的 seed。这样当一轮测试失败时,排查者可以先复用同一个值重跑,而不必依赖“这次可能再次随机到同一个输入”。
固定种子与失败持久化不是一回事
固定 seed 适合你已经知道某次运行的随机起点,并希望重新执行这一轮探索。它解决的是“同一测试配置下如何重放随机过程”。
失败持久化解决的问题更具体:某个输入导致了失败后,proptest 可以保存失败相关信息,后续运行优先重放历史失败案例。这样即使下一轮随机探索没有再次产生原始路径,回归测试仍能覆盖已经发现的问题。proptest 当前文档同时提供了 failure persistence 配置,并指出失败持久化依赖可重复的策略行为。([Docs.rs][1])
因此工程上可以把两者分开理解:seed 更像一次随机实验的“起点”,失败持久化更像已经发现的“证据”。修复缺陷后,应该确认原失败案例不再触发,而不是只确认某个固定 seed 的一轮测试通过。
重现失败时先固定条件
当 CI 出现 proptest 失败时,先记录测试名称、seed、失败信息以及仓库当前提交。随后在本地使用相同代码和配置重跑。若仍然失败,再根据 shrinking 后的最小反例定位业务逻辑。
不要只复制终端里最后一行错误。随机测试的复现依赖运行上下文;当策略、测试案例数或 RNG 算法改变后,即使 seed 数值相同,也不应默认它仍代表完全相同的输入序列。当前版本允许分别配置 cases、rng_algorithm 和 rng_seed,这也是排查时需要一起关注的原因。([Docs.rs][1])
最后把失败反例转成稳定的回归测试或保留失败持久化记录,使问题从“某次随机命中”变成“以后持续可验证的工程约束”。固定 seed 适合复现实验,持久化失败案例则更适合长期守住已经发现的边界缺陷。