Bazel构建libpqxx时linkopts失效、链接报错问题排查

你当前的构建配置存在三个核心问题，直接导致链接失败：

• cmake()规则的cache_entries参数写法错误：该参数的键名不需要手动添加-D前缀，你当前写的"DPostgreSQL_ROOT="会被规则拼接成无效的cmake参数-DDPostgreSQL_ROOT==/Library/PostgreSQL/14，直接导致PostgreSQL依赖路径识别异常。
• 静态库依赖链完全缺失：你只声明了libpqxx本身的静态库输出，没有将libpqxx依赖的底层PostgreSQL C库libpq、以及libpq依赖的OpenSSL（libssl、libcrypto）、zlib等系统库加入链接链路。你看到的_ASN1_STRING_*、_BIO_*类未定义符号，全部属于OpenSSL库，就是依赖缺失的直接表现。手动执行g++时系统的pkg-config会自动拉全这些隐式依赖，但Bazel构建默认不会自动解析系统库的隐式依赖，必须显式声明。
• 硬编码bazel-bin路径的方式违反Bazel构建规则：Bazel的所有编译链接动作都运行在隔离沙箱中，沙箱默认没有权限访问你写的绝对路径，且bazel-bin的实际路径会随构建模式、缓存状态变化，硬编码路径既不稳定也不符合沙箱访问规则。

1. 封装系统依赖 #

不要让cmake规则隐式查找系统库后丢失依赖传递，先把libpq及其依赖封装为Bazel可识别的目标。最省心的方式是用pkg_config规则自动拉全libpq的所有链接参数，不需要手动逐个写依赖：

load("@rules_cc//cc:defs.bzl", "cc_binary", "cc_library")
load("@rules_foreign_cc//foreign_cc:defs.bzl", "cmake", "pkg_config")

# 自动通过系统pkg-config识别libpq的头文件路径、所有依赖链接参数
pkg_config(
    name = "system_libpq",
    env = {
        "PKG_CONFIG_PATH": "/Library/PostgreSQL/14/lib/pkgconfig"
    },
    lib_name = "pq",
    visibility = ["//visibility:private"],
)

如果不想用pkg-config，也可以手动写cc_import/cc_library封装系统上的libpq，记得在linkopts里补上-lssl -lcrypto -lz这些libpq的必需依赖，否则还是会报未定义符号。

2. 修正cmake规则配置 #

修正cache_entries的写法，把封装好的libpq依赖加到cmake目标的deps里，同时不要硬编码带版本号的静态库名避免后续版本升级失效：

cmake(
    name = "pqxx",
    cache_entries = {
        "PostgreSQL_ROOT": "/Library/PostgreSQL/14",
        "SKIP_BUILD_TEST": "ON",
        "BUILD_SHARED_LIBS": "OFF",
    },
    lib_source = "@libpqxx//:all_srcs",
    visibility = ["//visibility:public"],
    # 不要硬写死7.7版本号，用out_lib_dir自动扫描目录下的静态库更稳定
    out_lib_dir = "lib",
    targets = ["pqxx"],
    # 把libpq依赖加入链路，规则会自动把依赖的头文件、链接参数透传给下游目标
    deps = [
        ":system_libpq",
    ],
)

3. 保持cc_binary的依赖配置不变 #

不需要给cc_binary加额外的链接参数，也不需要硬编码任何库路径，只要deps里依赖:pqxx即可，Bazel会自动把整条依赖链上的所有库、链接参数按顺序传给链接器：

cc_binary(
    name = "database_tester",
    srcs = ["database_access.cpp"],
    deps = [
          ":pqxx",
      ],
)

静态库本身不会存储自身的依赖信息，所以你用rules_foreign_cc编译第三方库时，必须把这个库的所有依赖都显式声明在deps里，规则才能正常完成依赖传递，否则必然会出现链接阶段找不到符号的问题。不要尝试直接引用bazel-bin下的输出文件，所有依赖都要通过Bazel规则的deps链路传递，才能适配沙箱构建逻辑。

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