使用bindgen处理C++头文件时Cargo触发FromBytesWithNulError panic求助

问题 #

使用Rust的bindgen对接C/C++ API时，处理C头文件正常，但处理C头文件时，Cargo在代码生成阶段触发FromBytesWithNulError panic，且错误未触发自定义的expect语句。已尝试修改头文件路径、添加clang参数强制处理C等方法，均无效，同时想了解如何调试build.rs。经确认此问题为已修复的bug，但当前使用的bindgen最新版本尚未包含该修复。

我的build.rs代码 #

fn main() {
    println!("cargo:rerun-if-changed=wrapper.hpp");

    let bindings = bindgen::Builder::default().header("src/wrapper.hpp").generate()
        .expect("Can't generate bindings");

    let out_path = std::path::PathBuf::from(std::env::var("OUT_DIR").unwrap());
    bindings.write_to_file(out_path.join("bindings.rs"))
        .expect("Can't write bindings to file");
}

错误输出 #

--- stderr
  thread 'main' panicked at 'called `Result::unwrap()` on an `Err` value: FromBytesWithNulError { kind: InteriorNul(1) }', C:\Users\tidem\.cargo\registry\src\github.com-1ecc6299db9ec823\bindgen-0.66.1\codegen\mod.rs:717:71
  stack backtrace:
     0: rust_begin_unwind
               at /rustc/84c898d65adf2f39a5a98507f1fe0ce10a2b8dbc/library\std\src/panicking.rs:579:5
     1: core::panicking::panic_fmt
               at /rustc/84c898d65adf2f39a5a98507f1fe0ce10a2b8dbc/library\core\src/panicking.rs:64:14
     2: core::result::unwrap_failed
               at /rustc/84c898d65adf2f39a5a98507f1fe0ce10a2b8dbc/library\core\src/result.rs:1750:5
     3: core::result::Result<T,E>::unwrap
     4: <bindgen::ir::var::Var as bindgen::codegen::CodeGenerator>::codegen
     5: <bindgen::ir::item::Item as bindgen::codegen::CodeGenerator>::codegen
     6: <bindgen::ir::module::Module as bindgen::codegen::CodeGenerator>::codegen::{{closure}}
     7: <bindgen::ir::module::Module as bindgen::codegen::CodeGenerator>::codegen
     8: <bindgen::ir::item::Item as bindgen::codegen::CodeGenerator>::codegen
     9: bindgen::codegen::codegen::{{closure}}
    10: bindgen::ir::context::BindgenContext::gen
    11: bindgen::codegen::codegen
    12: bindgen::Bindings::generate
    13: bindgen::Builder::generate
    14: build_script_build::main
    15: core::ops::function::FnOnce::call_once

解决方案 #

1. 解决panic问题 #

因为该bug已修复但未合并到当前稳定版本，可通过以下方式获取修复后的代码：

• 使用git依赖：在Cargo.toml中替换bindgen的版本为包含修复的git commit或分支：

  [dependencies]
  bindgen = { git = "https://github.com/rust-lang/rust-bindgen.git", rev = "替换为对应修复commit的哈希值" }
  

• 临时修改本地源码：找到本地cargo仓库中bindgen的路径（如错误信息里的C:\Users\tidem\.cargo\registry\src\github.com-1ecc6299db9ec823\bindgen-0.66.1），打开codegen/mod.rs定位到第717行，将unwrap()替换为安全的错误处理逻辑，比如：

  // 示例：用unwrap_or_else返回默认值，或根据场景跳过生成
  .unwrap_or_else(|_| "invalid_name".to_string())
  

  此方法仅作临时应急，bindgen版本更新后需恢复。

2. 调试build.rs的方法 #

• 直接运行编译后的build脚本：
  1. 先单独编译build.rs：cargo build --build-script
  2. 在target/debug/build/[你的项目名]-[随机哈希]/目录下找到build_script_build可执行文件，直接运行查看详细输出
• 添加调试日志：在build.rs中插入println!语句打印关键信息，比如：

  println!("DEBUG: 当前OUT_DIR路径: {}", std::env::var("OUT_DIR").unwrap());
  

  运行cargo build时会显示这些日志内容
• 使用调试器：用rust-gdb或rust-lldb直接调试build脚本：

  rust-gdb target/debug/build/[你的项目名]-[随机哈希]/build_script_build.exe
  

  在调试器中设置断点，逐步执行可定位panic的具体触发场景

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