WSL2 Ubuntu下Dockerfile交叉编译Rust/Bevy至Windows失败求助

问题背景 #

我对Docker及Rust交叉编译不熟悉，当前在WSL2的Ubuntu环境中尝试将项目编译至Windows平台，编译失败，请求指出问题所在。

我的Dockerfile #

FROM rust:latest

RUN apt update && apt upgrade -y
RUN apt install -y g++-mingw-w64-x86-64
RUN apt install -y build-essential
RUN apt install -y librust-alsa-sys-dev
RUN apt install -y g++ pkg-config libx11-dev libasound2-dev libudev-dev
RUN apt install -y libwayland-dev libxkbcommon-dev
RUN rustup target add x86_64-pc-windows-gnu

RUN rustup toolchain install stable-x86_64-pc-windows-gnu

WORKDIR /app
ENV PKG_CONFIG_ALLOW_CROSS=1/
ENV PKG_CONFIG_SYSROOT_DIR=/usr/x86_64-w64-mingw32/

CMD ["cargo", "build", "--target", "x86_64-pc-windows-gnu"]

（我确定可能安装了多余的包，但作为新手暂时如此）

Cargo.toml #

[package]
name = "bevy_try_1"
version = "0.1.0"
edition = "2021"

[profile.dev]
opt-level = 1

[profile.dev.package."*"]
opt-level = 3

[dependencies]
alsa = "0.7.0"
bevy = "0.10.1"
libc = "0.2"

（libc可能多余，但添加或移除不影响结果）

编译失败信息 #

Compiling alsa-sys v0.3.1
error[E0432]: unresolved imports `libc::pid_t`, `libc::pollfd`
 --> /usr/local/cargo/registry/src/index.crates.io-6f17d22bba15001f/alsa-sys-0.3.1/src/lib.rs:3:18
  |
3 | use libc::{FILE, pid_t, timeval, timespec, pollfd};
  |                  ^^^^^                     ^^^^^^ no `pollfd` in the root
  |                  |
  |                  no `pid_t` in the root

For more information about this error, try `rustc --explain E0432`.
error: could not compile `alsa-sys` (lib) due to previous error
warning: build failed, waiting for other jobs to finish...

我尝试仅保留空main函数编译，确认是依赖问题，结果仍出现相同错误。

构建/运行命令 #

构建：

docker build . -t rust_cross_compile/windows -f Dockerfile.windows

运行：

docker run --rm -ti -v `pwd`:/app rust_cross_compile/windows

问题分析与解决方案 #

核心问题 #

错误根源在于引入了Linux专属的音频依赖alsa：

1. alsa是Linux平台的音频系统库，Windows不存在对应的实现，交叉编译Windows目标时无法找到该库的编译支持。
2. 依赖的alsa-sys库中使用了libc的Linux特有类型（pid_t、pollfd），这些类型在Windows平台的libc中不存在，导致编译报错。

具体修复步骤 #

1. 移除不必要的依赖：编辑Cargo.toml，删除alsa = "0.7.0"这一行。Bevy框架会根据目标平台自动选择合适的音频后端（Windows下会使用winapi相关的音频实现），无需手动引入alsa。
2. 清理Dockerfile中的冗余包：删除与Linux音频相关的安装命令，比如RUN apt install -y librust-alsa-sys-dev和RUN apt install -y ... libasound2-dev ...，这些包对Windows交叉编译没有作用。
3. 修正环境变量错误：将ENV PKG_CONFIG_ALLOW_CROSS=1/改为ENV PKG_CONFIG_ALLOW_CROSS=1，去掉多余的斜杠。
4. 确保工具链正确关联：可以在Dockerfile中添加rustup default stable-x86_64-pc-windows-gnu，确保默认使用Windows目标的工具链，或者在cargo build命令中指定--toolchain stable-x86_64-pc-windows-gnu。

修复后的Dockerfile示例：

FROM rust:latest

RUN apt update && apt upgrade -y
RUN apt install -y g++-mingw-w64-x86-64 build-essential g++ pkg-config libx11-dev libudev-dev libwayland-dev libxkbcommon-dev
RUN rustup target add x86_64-pc-windows-gnu
RUN rustup toolchain install stable-x86_64-pc-windows-gnu
RUN rustup default stable-x86_64-pc-windows-gnu

WORKDIR /app
ENV PKG_CONFIG_ALLOW_CROSS=1
ENV PKG_CONFIG_SYSROOT_DIR=/usr/x86_64-w64-mingw32/

CMD ["cargo", "build", "--target", "x86_64-pc-windows-gnu"]

修复后的Cargo.toml示例：

[package]
name = "bevy_try_1"
version = "0.1.0"
edition = "2021"

[profile.dev]
opt-level = 1

[profile.dev.package."*"]
opt-level = 3

[dependencies]
bevy = "0.10.1"

内容的提问来源于stack exchange，提问作者Petre Mugur Gherman