From 2b048b94a3190a1bc30306cd576a595691edad4a Mon Sep 17 00:00:00 2001 From: xfy Date: Fri, 24 Jul 2026 10:52:51 +0800 Subject: [PATCH] =?UTF-8?q?fix(utils):=20sleep=5Fms=20=E7=9A=84=20cfg=20gu?= =?UTF-8?q?ard=20=E5=AF=B9=E9=BD=90=20feature=20=E6=A8=A1=E5=9E=8B?= =?UTF-8?q?=EF=BC=8C=E4=BF=AE=E5=A4=8D=20web-only=20=E6=9E=84=E5=BB=BA?= =?UTF-8?q?=E5=A4=B1=E8=B4=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit sleep_ms 原用 #[cfg(not(target_arch = "wasm32"))] guard tokio::time::sleep， 但 tokio 是 server-only 的 optional 依赖。此 guard 会在「非 wasm32 主机 + 仅 web feature」组合（如 cargo build --no-default-features --features web）下 误激活，此时 tokio 未引入，导致编译失败。 该 bug 长期被 [dev-dependencies] tokio 掩盖——cargo test / 开发构建总能拿到 tokio，只有发布/生产构建（排除 dev-deps）才暴露。符合 AGENTS.md 第 1 条 dual-target gating 标准：触及 server-only 依赖的代码必须用 #[cfg(feature = "server")] 而非 target_arch 区分。 修复：tokio 版本改为 #[cfg(all(feature = "server", not(target_arch = "wasm32")))]， 并为无效构建组合「非 wasm32 且非 server」补一个 panic stub（该组合不是有效部署 目标，web feature 真实构建目标即 wasm32；stub 仅保证符号可编译，运行时不会触发）。 调用点 runner.rs 的 server 占位分支（通过 sleep_ms 继承同一问题）无需改动—— 它只在 server target 下编译运行，sleep_ms 修复后其调用自然可编译。 --- src/utils/time.rs | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/src/utils/time.rs b/src/utils/time.rs index 82ad481..162c4d7 100644 --- a/src/utils/time.rs +++ b/src/utils/time.rs @@ -35,11 +35,26 @@ pub async fn sleep_ms(ms: u32) { } /// 异步睡眠指定毫秒数（原生 tokio 版本）。 -#[cfg(not(target_arch = "wasm32"))] +/// +/// 仅在 `server` feature 启用且非 wasm32 目标下编译。`tokio` 是 server-only 的 +/// optional 依赖（见 Cargo.toml），不可用 `#[cfg(not(target_arch = "wasm32"))]`—— +/// 那样会在「非 wasm32 主机 + 仅 web feature」组合下误激活，此时 tokio 未引入， +/// 导致编译失败（此 bug 曾被 `[dev-dependencies] tokio` 掩盖，发布构建才暴露）。 +#[cfg(all(feature = "server", not(target_arch = "wasm32")))] pub async fn sleep_ms(ms: u32) { tokio::time::sleep(std::time::Duration::from_millis(ms as u64)).await; } +/// `sleep_ms` 的占位 stub，仅用于「非 wasm32 且非 server」的无效构建组合。 +/// +/// 此组合（如非 wasm32 主机执行 `cargo build --features web`）不是有效部署目标—— +/// web feature 的真实构建目标就是 wasm32，会走上面的 JS setTimeout 分支。 +/// 此 stub 仅保证符号可编译，永远不会在有效运行时被调用；若被调用说明部署配置错误。 +#[cfg(all(not(feature = "server"), not(target_arch = "wasm32")))] +pub async fn sleep_ms(_ms: u32) { + panic!("sleep_ms 在非 wasm32 且非 server 的无效构建组合下被调用：请检查 feature 配置"); +} + /// 获取当前时间戳（毫秒）。 /// /// WASM 端使用 `js_sys::Date::now()`，服务端回退到 `chrono::Utc`。