Rust并行测试时，Lazy::new是否能保证仅被调用一次？

单元测试场景下的有效性 #

once_cell::sync::Lazy的核心是全局同步的延迟初始化，在默认单进程多线程的cargo test运行模式下，不管多少测试用例并发调用初始化逻辑，它只会执行一次：

• 首次调用触发初始化，后续所有调用直接返回已准备好的数据库连接。
• 内部依赖同步原语（如Mutex+Once），能完全避免“数据库校验”步骤的竞态条件，初始化过程是原子性的，同一时间仅一个线程能执行该逻辑。

文档测试的特殊情况 #

文档测试的运行机制和普通单元测试不同：Rust会为每个代码块启动独立进程执行。这意味着：

• 每个文档测试进程都有独立的Lazy实例，初始化函数会在每个进程中各执行一次，无法跨进程共享初始化结果。
• 若数据库初始化代价高或要求全量测试仅初始化一次，Lazy的单例控制在文档测试中会失效。

优化建议 #

如果想让文档测试也复用数据库初始化结果，可尝试这些方案：

• 将数据库初始化逻辑抽为独立前置脚本，在运行cargo test（含文档测试）前手动执行，测试代码仅做只读查询。
• 用cargo test --doc --no-run生成测试二进制文件，手动控制执行顺序，或共享已初始化的连接池（实现相对繁琐）。
• 考虑用测试容器管理数据库实例，配合全局初始化脚本，更灵活地控制测试环境生命周期。

内容的提问来源于stack exchange，提问作者cameron1024