本地编译Rust的cassandra-cpp项目遇链接错误求助

尝试运行cassandra-cpp的simple示例，但编译时出现链接错误，首次接触带C依赖的Rust库，不清楚本地编译运行的正确方式。

错误信息 #

error: linking with `cc` failed: exit status: 1
  |
  = note: env -u IPHONEOS_DEPLOYMENT_TARGET -u TVOS_DEPLOYMENT_TARGET LC_ALL=
  = note: ld: warning: search path '/usr/lib/x86_64-linux-gnu' not found
          ld: warning: search path '/usr/local/lib/x86_64-linux-gnu' not found
          ld: warning: search path '/usr/local/lib64' not found
          ld: warning: search path '/usr/lib64/' not found
          ld: warning: search path '/usr/local/opt/openssl/lib' not found
          ld: library 'cassandra' not found
          clang: error: linker command failed with exit code 1 (use -v to see invocation)

代码 - main.rs #

use cassandra_cpp::*;

#[tokio::main]
async fn main() -> Result<()> {
    let mut cluster = Cluster::default();
    cluster.set_contact_points("127.0.0.1").unwrap();
    cluster.set_load_balance_round_robin();
    let session = cluster.connect().await?;

    let result = session
        .execute("SELECT keyspace_name FROM system_schema.keyspaces;")
        .await?;
    println!("{}", result);

    let mut iter = result.iter();
    while let Some(row) = iter.next() {
        let col: String = row.get_by_name("keyspace_name")?;
        println!("ks name = {}", col);
    }

    Ok(())
}

Cargo.toml #

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

[dependencies]
cassandra-cpp = "3.0.2"
tokio = { version = "1.39.2", features = ["rt", "rt-multi-thread", "macros"] }

补充说明 #

已安装DataStax驱动，但问题仍未解决；尝试通过Dockerfile安装floki，依旧无效。

链接错误的核心是链接器找不到cassandra库文件，按以下步骤排查修复：

• 确认DataStax驱动的安装路径
  找到安装的libcassandra.so（Linux）或libcassandra.dylib（macOS）文件位置，常见路径包括/usr/local/lib、/opt/datastax-cpp-driver/lib或自定义安装目录。执行命令快速查找：

  find / -name "libcassandra*" 2>/dev/null
  

• 让链接器能找到库文件

  • 临时生效：运行cargo run前设置环境变量指定库路径：

    # Linux
    export LD_LIBRARY_PATH=/path/to/libcassandra/directory:$LD_LIBRARY_PATH
    # macOS
    export DYLD_LIBRARY_PATH=/path/to/libcassandra/directory:$DYLD_LIBRARY_PATH
    

  • 永久生效：将上述环境变量添加到~/.bashrc（Linux）或~/.zshrc（macOS），重启终端后生效。

• 检查驱动版本兼容性
  cassandra-cpp crate 3.0.2需要对应版本的DataStax C++驱动，建议安装4.15.x或兼容版本，避免版本不匹配导致链接失败。

• 手动指定库路径给cargo
  在项目根目录创建.cargo/config.toml，替换路径后添加以下内容：

  [target.x86_64-unknown-linux-gnu]
  rustflags = [
      "-L", "/path/to/libcassandra/directory",
  ]
  

  macOS对应target为x86_64-apple-darwin或aarch64-apple-darwin，按需修改。

• 重新编译验证
  执行cargo clean清除旧编译缓存，再运行cargo run。

• Docker环境修复（如果用Docker）
  放弃安装floki，直接基于官方Rust镜像安装DataStax驱动依赖，示例Dockerfile：

  FROM rust:1.79-slim-bookworm
  
  RUN apt-get update && apt-get install -y --no-install-recommends \
      libssl-dev \
      wget \
      gnupg2 \
      && wget -qO - https://downloads.datastax.com/cpp-driver/debian/repo_key | apt-key add - \
      && echo "deb https://downloads.datastax.com/cpp-driver/debian bookworm main" | tee /etc/apt/sources.list.d/datastax.list \
      && apt-get update && apt-get install -y --no-install-recommends libcassandra-dev \
      && apt-get clean && rm -rf /var/lib/apt/lists/*
  
  WORKDIR /app
  COPY . .
  RUN cargo build --release
  CMD ["./target/release/rust_cassandra"]
  

  构建并运行镜像：docker build -t rust-cassandra . && docker run rust-cassandra

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