Bazel CGo链接错误.so文件路径，如何移除多余前缀？

问题描述 #

用Bazel构建带CGo的项目时，生成的二进制文件通过lld查看动态依赖，会发现依赖路径带了不存在的前缀bazel-out/k8-fastbuild-ST-<some-hash>/bin/，但实际存在的路径是_solib_k8/<some-path>/<my-library>.so，导致运行时可能找不到依赖库。

修复方案 #

• 调整链接时的rpath参数
  直接在go_binary或依赖的cc_library规则中，通过linkopts添加rpath配置，指定运行时查找.so文件的相对路径。比如二进制在bazel-out/.../bin目录，而_solib_k8在上级目录，就加：

  go_binary(
      name = "my_binary",
      srcs = ["main.go"],
      cgo = True,
      linkopts = ["-Wl,-rpath,$ORIGIN/../_solib_k8"],
      deps = [":my_c_lib"],
  )
  

  这样二进制运行时会自动从当前目录的上级找_solib_k8下的库。

• 用cc_import规则封装.so依赖
  别在CGo代码里直接写.so的路径，改用Bazel的cc_import规则管理动态库，让Bazel自动处理依赖路径：

  cc_import(
      name = "my_c_lib",
      shared_library = "path/to/my-library.so",
  )
  
  go_binary(
      name = "my_binary",
      srcs = ["main.go"],
      cgo = True,
      deps = [":my_c_lib"],
  )
  

• 静态链接规避动态路径问题
  如果项目允许静态链接，构建时加--dynamic_mode=off参数，让Bazel把.so里的符号直接打包进二进制，彻底不用管动态依赖路径：

  bazel build //path/to:my_binary --dynamic_mode=off
  

• 用bazel run启动二进制
  直接用bazel run //path/to:my_binary启动，Bazel会自动设置正确的环境变量和工作目录，确保二进制能找到对应的.so文件，不用手动调整路径。

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