libpqxx是C++连接PostgreSQL最成熟推荐方案，类型安全重写libpq，支持异常、RAII、参数化查询防SQL注入；链接时必须-lpqxx在-lpq前；敏感信息应通过环境变量或.pgpass管理；写操作须用transaction+parameterized query；长期服务需处理连接失效并避免共享connection对象。
libpqxx 是当前 C++ 连接 PostgreSQL 最成熟、最推荐的方式——它不是简单封装，而是对 libpq 的类型安全重写，自带异常机制、RAII 资源管理、参数化查询支持，能直接防止 SQL 注入，也天然适配现代 C++ 项目结构。
编译链接时 -lpqxx 和 -lpq 的顺序不能颠倒
很多初学者在链接阶段遇到 undefined reference to `PQconnectdb' 或类似符号未定义错误，根本原因就是链接器顺序错了。
因为 libpqxx 是基于 libpq 构建的，所有底层网络、认证、协议解析都由后者提供。链接器从左到右解析依赖，所以必须先指定高层库，再放其依赖：
-
-lpqxx必须出现在-lpq前面（例如：g++ main.cpp -lpqxx -lpq） - 在 CMake 中要显式声明依赖关系：
target_link_libraries(myapp pqxx pq) - Windows 下用 vcpkg 安装后，还需额外链接
ws2_32.lib（网络初始化）和wsock32.lib（兼容旧接口）
连接字符串里不要硬编码密码，尤其别提交到 Git
像 "host=localhost port=5432 dbname=test user=postgres password=123456" 这种写法，在开发初期看似方便，但极易导致凭据泄露。
立即学习“C++免费学习笔记（深入）”；
更稳妥的做法是把敏感字段抽离：
- 使用环境变量：读取
std::getenv("PGPASSWORD")，连接字符串中写成"host=localhost ... password=" + std::string(pw) - 或改用 PostgreSQL 的配置文件机制：创建
~/.pgpass（Linux/macOS）或%APPDATA%\postgresql\pgpass.conf（Windows），格式为host:port:database:username:password，并设严格权限（chmod 600 ~/.pgpass） -
pqxx::connection会自动识别这些配置，无需改动代码逻辑
执行 INSERT/UPDATE 一定要用 transaction + parameterized query
裸写 exec("INSERT INTO users VALUES (" + name + ", " + age + ")") 不仅危险，还可能因字符串拼接引发语法错误（比如 name 含单引号或空值）。
正确路径是通过 pqxx::work 开启事务，并用占位符绑定参数：
pqxx::connection conn(connstr);
pqxx::work txn(conn);
txn.exec_params("INSERT INTO users (name, age) VALUES ($1, $2)", "Alice", 30);
txn.commit();
-
$1,$2是 PostgreSQL 协议原生占位符，由服务端解析，完全规避客户端拼接风险 - 事务包裹确保原子性；即使中间出错，也能靠
txn.abort()回滚，不会留下脏数据 - 注意：如果只是单条 SELECT，可用
conn.exec()；但涉及写操作，务必进work或nontransaction（仅用于不修改数据的语句）
长期运行服务必须处理连接失效与重连
PostgreSQL 默认会在空闲 30 分钟后断开连接（由 tcp_keepalives_idle 和服务端 idle_in_transaction_session_timeout 控制），而 pqxx::connection 对象本身不会自动重连。
常见表现是某次 exec() 突然抛出 pqxx::broken_connection 异常，后续调用全失败。
- 简单策略：捕获该异常后，新建
pqxx::connection实例重试（适合低频请求） - 高并发场景应实现连接池，每次从池中取连接前调用
conn.is_open()+conn.ping()（libpqxx 7.7+ 支持）验证活性 - 避免在类成员中长期持有单个
pqxx::connection对象——它不是线程安全的，多线程共享会导致未定义行为
真正难的从来不是第一次连上数据库，而是让连接在进程跑几天、几周后依然可靠；参数绑定防注入只是基础，连接生命周期管理、线程隔离、错误分类捕获，才是数据持久化落地时最容易被跳过的环节。
