Docker下x86_64-unknown-linux-musl目标编译Rust fasthash库失败如何解决？

问题根本原因 #

本次编译失败的核心是fasthash依赖的底层C实现t1ha哈希库，在Alpine musl环境下默认开启的CPU指令集自动检测逻辑出错，尝试编译当前容器环境不支持的AVX2、AES等指令集代码导致编译失败。

解决方案 #

方案一：裁剪fasthash依赖特性（最优解） #

你当前仅使用fasthash的murmur3算法，可关闭默认开启的全算法特性，仅保留需要的murmur3特性，跳过其他不需要的C代码编译：
修改Cargo.toml中的fasthash依赖声明：

fasthash = { version = "0.4.0", default-features = false, features = ["murmur3"] }

该方案完全保留fasthash的murmur3性能，编译速度更快，无额外依赖。

方案二：禁用t1ha的高级指令集检测 #

如果需要使用fasthash的全量算法，可在编译时添加C编译参数，强制关闭t1ha的指令集自动检测逻辑，修改Dockerfile中的cargo build命令：

RUN CFLAGS="-DT1HA0_RUNTIME_SELECT=0 -DT1HA0_AESNI_AVAILABLE=0" cargo build --release --target x86_64-unknown-linux-musl

方案三：补充依赖&升级版本 #

如果以上方案仍有问题，可做如下调整：

• 在apk add命令中新增linux-headers包，补全C代码编译所需的Linux内核头文件
• 将基础镜像从rust:1.54.0-alpine升级为更高版本的Rust镜像，新版本Rust及配套的cc-rs编译工具已修复大量musl环境下的C依赖编译问题
• 升级mimalloc依赖到最新版本，修复旧版本mimalloc在musl环境下的编译冲突

所有方案均不会损失fasthash的原有性能，编译通过后可正常使用。

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