讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何连接PostgreSQL数据库?(libpq使用示例)

雨墨吖_2528

雨墨吖_2528

发布时间:2026-02-18 14:40:33

|

348人浏览过

|

来源于php中文网

原创

libpqxx 是 C++ 连接 PostgreSQL 的首选封装——它基于官方 libpq,通过 RAII 自动管理连接、事务和结果,避免裸调 libpq 的内存泄漏与错误;链接时须 -lpqxx -lpq 顺序正确,密码应通过环境变量或 ~/.pgpass 安全管理。

c++如何连接postgresql数据库?(libpq使用示例)

libpq 是 C++ 连接 PostgreSQL 的唯一靠谱选择

不是“可以用”,而是“必须用”——C++ 标准库不提供数据库连接能力,libpq 是 PostgreSQL 官方 C 接口,所有 C++ 封装(如 libpqxx)都构建在其之上。绕过它去试 ODBC 或手写 TCP 协议,等于自己重造轮子还带 bug。

直接用 libpqxx 比裸调 libpq 更安全

裸调 libpq 要手动管理 PQconnectdb 返回的 PGconn*、检查 PQstatus、逐字节处理 PQexec 结果、自己 PQclear 和 PQfinish——漏一步就内存泄漏或连接堆积。而 libpqxx 把这些全包进 RAII:

  • connection 构造即连,析构自动断开
  • transaction 对象保证 commit/rollback 成对,异常时自动回滚
  • 查询结果用 result 包装,列名/索引访问统一,不用再算 PQnfields 和 PQgetvalue 偏移

示例:插入一行并获取自增 ID

try {
  pqxx::connection conn("host=localhost port=5432 dbname=test user=me password=123");
  pqxx::work tx{conn};
  auto r = tx.exec_params("INSERT INTO users(name) VALUES ($1) RETURNING id", "alice");
  int id = r[0][0].as<int>();
  tx.commit();
} catch (const std::exception &e) {
  // 自动 rollback,conn 自动 close
}

编译链接时 -lpqxx -lpq 顺序不能错

libpqxx 依赖 libpq,但链接器只按命令行顺序解析符号。如果写成 g++ main.cpp -lpq -lpqxx,链接器在处理 libpqxx 时还没看到 libpq 提供的 PQconnectdb 等符号,就会报一堆 undefined reference to 'PQ...' 错误。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

立即学习“C++免费学习笔记(深入)”;

  • 正确顺序:-lpqxx -lpq(先告诉链接器“我要用 pqxx”,再补上它依赖的 pq)
  • 头文件包含顺序无关紧要,但确保 #include <pqxx/pqxx> 前已安装好开发包(如 Ubuntu 上 sudo apt install libpqxx-dev)
  • macOS 用 Homebrew 安装后,可能需加 -L/opt/homebrew/lib(Apple Silicon)或 -L/usr/local/lib(Intel)

连接字符串里 password 不要硬编码,更别放 git 里

哪怕只是本地调试,把密码写死在 "password=123" 里也极危险。PostgreSQL 支持多种凭据加载方式,优先级从高到低:

  • PGPASSWORD 环境变量(最简单,适合 CI 或临时测试)
  • ~/.pgpass 文件(格式:host:port:database:username:password,权限必须 0600)
  • 连接字符串中显式写 password=xxx(仅限 throwaway demo)

常见坑:~/.pgpass 权限不对会静默失效——ls -l ~/.pgpass 必须显示 -rw-------,否则 PostgreSQL 直接忽略该文件,报 fe_sendauth: no password supplied。

连接池、SSL 配置、异步查询这些是后续才要碰的点;现在先把 libpqxx 跑通、错误能捕获、资源不泄漏,就已经跨过了最大门槛。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1758

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2744

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6104

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5769

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7414

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

10914

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

5599

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

6087

2025.08.07

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn