libpqxx连接PostgreSQL需捕获sql_error异常处理失败,用std::string传连接串;防SQL注入须用exec_params或prepare绑定参数;事务由work对象生命周期自动管理;取结果须用row["col"].as()或.to()避免崩溃。
libpqxx 是 C++ 最主流的 PostgreSQL 客户端库,但它不自动重连、不隐藏底层错误。连接失败时,connection 构造函数会直接抛出 sql_error 或 broken_connection 异常,而不是返回 null 指针。
std::string 传入,不能用 C 风格字符串字面量(如 "host=localhost port=5432"),否则可能触发隐式转换问题;推荐写成 std::string("host=localhost port=5432 dbname=test")
"Connection refused"(目标机器拒绝连接) 或 "FATAL: password authentication failed" 都来自异常的 e.what(),需捕获 const pqxx::sql_error& 而非通用 std::exception 才能拿到 SQL 状态码(e.sqlstate())connection 对象,注意 PostgreSQL 的 max_connections 限制和 TCP TIME_WAIT 积压libpqxx 不支持字符串拼接构造查询,所有用户输入必须通过 prepared statement 或 parameterized query 绑定。直接用 exec("SELECT * FROM users WHERE id = " + std::to_string(uid)) 是严重漏洞。
work 对象的 exec_params():它自动转义并匹配 PostgreSQL 类型,例如 w.exec_params("SELECT name FROM users WHERE age > $1 AND active = $2", 18, true)
$1, $2…… 顺序编号,不能用 :name 或 @p1;类型推导依赖传入的 C++ 值,如传 int 就对应 INTEGER,传 std::string 默认为 TEXT
conn.prepare("get_user", "SELECT * FROM users WHERE id = $1"),再用 w.exec_prepared("get_user", 123);prepare 在连接生命周期内只需一次libpqxx 的事务不是“开启/提交”两步操作,而是由 transaction_base 派生类(如 work、nontransaction、transaction)的生命周期控制。析构时自动提交或回滚——但仅当未显式调用 commit() 或 abort()。
pqxx::work w{conn} 最安全:它在作用域结束时自动 commit;若中途 throw 异常,析构函数自动 abort(等价于 ROLLBACK)w.commit() 后还继续用 w——这会触发 std::logic_error("Transaction already committed")
readonly_transaction,但注意它仍会获取 snapshot,对大表扫描仍有开销libpqxx 返回的 result 是行容器,但它的迭代器不是 STL 风格的 begin()/end(),且字段访问必须用列名或索引,越界或类型不匹配会抛异常。
for (const auto &row : r) {
std::string name = row["name"].as();
int id = row[0].as(); // 按索引取,从 0 开始
} row["col_name"] 返回 field,必须显式调用 .as() 转换;若字段为 NULL,.as() 抛 conversion_error,应改用 .to(T{}) 提供默认值r.size() == 0,但别假设 r.begin() == r.end() —— libpqxx 的 result::iterator 不保证可比较,应优先用 size() 或范
围 forexec() 全部拉取,改用 stream_from 流式读取,否则内存暴涨且无法中断事务的边界由对象生命周期硬性约束,不是靠代码注释或命名约定;很多崩溃源于在 work 对象析构前忘了 catch 异常,或在 commit() 后误用已失效的事务对象。