Rust应用依赖libmpv-sys在i686架构编译失败（x64正常）

看起来你遇到的是典型的32位与64位架构下结构体大小/对齐不匹配导致的编译问题，咱们一步步拆解原因和解决办法：

问题根源 #

咱们先搞懂为啥x64正常、i686报错：

• libmpv-sys是用bindgen自动生成C库绑定的，生成过程中可能默认以64位（x86_64）架构为基准，给绑定代码加了一堆结构体大小/对齐的常量检查（比如判断mpv_node的大小是否为16字节）。
• 但i686是32位架构，指针、部分字段的大小会从8字节缩水到4字节，导致结构体实际大小比64位下小一圈（比如报错里mpv_node在i686上实际是12字节，代码里却硬要减16，自然就溢出了）。
• 这些检查是用来确保Rust绑定和系统里的libmpv二进制接口一致，但没考虑32位架构的场景，所以就炸了。

解决办法 #

1. 先确认系统依赖是32位版本 #

在i686机器上编译，必须先把32位的libmpv开发环境装到位：

• 如果你用Debian/Ubuntu系，安装libmpv-dev:i386；红帽/CentOS系则装mpv-devel.i686。
• 验证下：运行pkg-config --libs --cflags mpv，输出里应该有-m32相关参数，或者用file $(which mpv)确认是32位二进制。

2. 给bindgen传递32位编译参数 #

手动告诉bindgen针对i686架构生成绑定，编译前先设置环境变量：

export CFLAGS="-m32" CXXFLAGS="-m32"

然后再执行你的编译命令：

cargo build --target i686-unknown-linux-gnu

这样bindgen会用32位规则计算结构体大小，生成的检查代码就不会溢出了。

3. 临时 workaround：手动修改绑定代码 #

如果上面的方法暂时没生效，可以先临时改生成的绑定文件救急：

• 找到报错路径里的bindings.rs（比如/home/user/project/target/i686-unknown-linux-gnu/debug/build/libmpv-sys-xxx/out/bindings.rs）
• 把那些溢出的检查代码改成适配32位的断言，比如把：

  ["Size of mpv_node"][::std::mem::size_of::<mpv_node>() - 16usize];
  

  替换成：

  assert_eq!(::std::mem::size_of::<mpv_node>(), 12usize, "Size of mpv_node");
  

  注意每个结构体的实际大小要对应报错里的数值（比如mpv_byte_array在i686是8字节，就改成断言等于8）。

  提示：这个方法每次重新构建都会被覆盖，只能临时用，最好还是从根源上修复。

4. 给libmpv-rs提修复（长期方案） #

你用的是libmpv-rs的PR#40分支，看起来这个分支还没处理32位架构的情况。你可以：

• 看看仓库里有没有已经解决这个问题的PR，切换到对应分支编译。
• 自己提一个修复PR：让构建脚本根据目标架构动态调整结构体大小的检查值，或者直接移除这些硬编码的检查（bindgen本身已经能自动适配架构差异，这类硬编码检查其实没必要）。

5. 确认Rust工具链的32位支持 #

最后再补个小检查：确保你已经安装了i686的Rust目标工具链：

rustup target add i686-unknown-linux-gnu

内容来源于stack exchange