使用Bevy 0.12构建Wasm时持续编译bevy-render 0.11.3的问题

问题背景 #

基于foxtrot v0.3.0重构（移除particles插件、添加自定义功能）后，使用命令RUSTFLAGS=--cfg=web_sys_unstable_apis trunk build --release构建Wasm时出现异常：

• 原生构建正常，但Wasm构建持续编译bevy-render 0.11.3（项目指定版本为0.12）
• 执行cargo update尝试修复后，触发Serde相关依赖错误

解决方案 #

1. 强制锁定Bevy全版本依赖 #

在项目Cargo.toml中明确指定所有Bevy相关 crate 的0.12版本，避免依赖解析时拉取旧版本：

[dependencies]
bevy = "0.12"
bevy-render = "0.12"
# 其他Bevy子crate（如bevy-core、bevy-window等）也统一指定0.12版本

执行cargo tree -p bevy-render排查引入旧版本的依赖源，找到后通过patch强制覆盖版本：

[patch.crates-io]
bevy-render = { version = "0.12" }

2. 重置依赖锁文件 #

直接删除项目根目录的cargo.lock，执行以下命令重新生成适配Wasm目标的依赖锁：

cargo check --target wasm32-unknown-unknown

避免使用cargo update全量更新依赖，防止引发连锁冲突。

3. 修复Serde版本冲突 #

若cargo update后出现Serde错误，说明存在依赖版本不兼容问题：

• 在Cargo.toml中统一Serde版本：

[dependencies]
serde = { version = "1.0", features = ["derive"] }

• 执行cargo tree -p serde查看依赖树，定位冲突的依赖包，针对性调整其版本或通过patch强制兼容。

4. 清理Trunk缓存并重新构建 #

执行以下命令清理Trunk缓存，确保构建环境使用最新的依赖配置：

trunk clean

随后重新执行Wasm构建命令：

RUSTFLAGS=--cfg=web_sys_unstable_apis trunk build --release

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