The global thread pool has already been initialized

主线位置：全局池的创建。机制在 全局池与 Registry。

flowchart TB
  first["第一次碰全局池的调用"] --> once{"THE_REGISTRY_SET.call_once"}
  once -->|"隐式：join / par_iter / current_num_threads"| dflt["默认配置建池"]
  once -->|"显式：build_global"| cfg["你的配置建池，返回 Ok"]
  dflt --> later["之后的 build_global：call_once 不再执行"]
  later --> err["Err(GlobalPoolAlreadyInitialized)"]

现象

main 里写了

rayon::ThreadPoolBuilder::new().num_threads(4).build_global().unwrap();

运行时 panic：

called `Result::unwrap()` on an `Err` value: ThreadPoolBuildError { kind: GlobalPoolAlreadyInitialized }

或者没有 unwrap，错误被忽略，线程数、线程名、panic_handler 都没有生效，rayon::current_num_threads() 仍是核数。Display 的文字是「The global thread pool has already been initialized.」。

复现

实验 E10（exp-rayon/global-init/ 的 after_use），先 rayon::join(|| 1, || 2)，再 build_global(num_threads(4))，3 次输出相同：

join -> (1, 2), threads=12
build_global after join -> Err(ThreadPoolBuildError { kind: GlobalPoolAlreadyInitialized })
Display: The global thread pool has already been initialized.
threads still=12

反向验证：build_global 作为第一次调用返回 Ok(())，池大小是设定值；第二次 build_global 返回同样的 Err，池大小不变（全局池与 Registry）。

从哪来

全局池是一个 static mut THE_REGISTRY 加一个 Once。set_global_registry 先把结果预设成 Err(GlobalPoolAlreadyInitialized)，只有 call_once 里的闭包真正执行时才改成 Ok。两条路都经过它：

• 任何隐式用到全局池的调用（join、scope、spawn、par_iter、current_num_threads……从非 worker 线程调用时）走 global_registry()，以默认配置 call_once；
• build_global 走 init_global_registry，以你的配置 call_once。

谁先到谁赢，Once 不会执行第二次。文档在 build_global 上写得很直接：「Once started, the configuration cannot be changed」。

最常见的「先到者」：

• 库代码在初始化时跑了一次 par_iter（或者 rayon::current_num_threads() 被用来算缓冲区大小）；
• 测试：cargo test 在同一个进程里跑多个测试，第一个碰 rayon 的测试决定了全局池，其他测试里的 build_global 都失败；
• 日志、指标初始化之前的某个依赖已经用了全局池。

怎么改

• 配置放在 main 的第一行，在任何可能间接调用 rayon 的初始化之前；返回的 Err 至少要记日志，不要 unwrap() 也不要 let _ = 静默丢掉。
• 不依赖全局池的配置：建一个私有池 let pool = ThreadPoolBuilder::new().num_threads(4).build()?;，把工作 pool.install(|| ...) 进去。install 里的 par_iter 会留在这个池里（in_worker：从哪进池）。库代码尤其应该这样做，不要替应用决定全局池。
• 只想控制线程数：用环境变量 RAYON_NUM_THREADS，它在全局池被隐式创建时读取，没有先后问题（解析规则见 RAYON_NUM_THREADS=0 不是「不并行」）。
• 测试里：每个测试用自己的私有池，或者用一个 std::sync::Once 包住的初始化函数，所有测试先调它。

小结

• 全局池懒初始化、只建一次；第一次隐式使用就用默认配置把它建好，之后的 build_global 返回 GlobalPoolAlreadyInitialized（E10）。
• 改法：build_global 放在最前面并检查返回值；库和测试用私有池加 install；只调线程数就用 RAYON_NUM_THREADS。