fix(utils): sleep_ms 的 cfg guard 对齐 feature 模型,修复 web-only 构建失败
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 修复后其调用自然可编译。
This commit is contained in:
parent
5a10b07bff
commit
2b048b94a3
@ -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`。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user