Visual Studio 2022中C++结合libpqxx连PostgreSQL遇LNK2019错误求助

问题详情 #

我对源文件了解不多，但已安装libpqxx、vcpkg以及PostgreSQL，并通过CMake完成配置生成。尝试运行pqxx教程中的代码（如下）时，出现链接器错误LNK2019（提示未解析的public、private、protected符号），已在VS属性中设置路径但问题仍未解决，寻求帮助。

测试代码 #

#pragma once

#include <string>
#include <iostream>
#include <pqxx/pqxx>

int main()
{
    std::string connectionString = "host=localhost port=5432 dbname=test user=postgres password =123454321";

    try
    {
        pqxx::connection connectionObject(connectionString.c_str());

        pqxx::work worker(connectionObject);

        pqxx::result response = worker.exec("SELECT * FROM users");

        for (size_t i = 0; i < response.size(); i++)
        {
            std::cout << "Id: " << response[i][0] << " Username: " << response[i][1] << " Password: " << response[i][2] << " Email: " << response[i][3] << std::endl;
        }
    }
    catch (const std::exception& e)
    {
        std::cerr << e.what() << std::endl;
    }

    system("pause");
}

排查与解决步骤 #

LNK2019错误的核心是编译阶段能找到头文件，但链接阶段找不到对应函数的实现库，按以下步骤逐一排查：

• 修正CMake配置（关键）
  既然用vcpkg和CMake构建，不要手动在VS属性里设置路径，vcpkg会自动处理依赖。确保CMakeLists.txt包含以下配置：

  # 查找libpqxx包
  find_package(pqxx REQUIRED)
  # 将库链接到你的项目，替换成实际项目名称
  target_link_libraries(你的项目名称 PRIVATE pqxx::pqxx)
  

  重新生成CMake项目，让vcpkg自动注入正确的库路径和依赖。

• 匹配vcpkg编译架构
  确认安装libpqxx时使用的triplet（编译架构）和当前VS项目的平台一致：

  • 若项目用x64平台，安装命令为vcpkg install pqxx:x64-windows
  • 若用x86平台，安装命令为vcpkg install pqxx:x86-windows
    架构不匹配会导致链接时找不到对应平台的库文件。

• 检查链接器依赖项
  在VS项目属性的链接器->输入中，确认附加依赖项包含pqxx.lib（静态库）或pqxx.dll.lib（动态库导入库）。如果vcpkg未自动添加，手动补充对应库名。

• 补全PostgreSQL依赖
  libpqxx依赖PostgreSQL的libpq库，需确保：

  1. PostgreSQL的lib目录（例如C:\Program Files\PostgreSQL\16\lib）被添加到链接器->常规->附加库目录
  2. 附加依赖项中添加libpq.lib

• 处理动态库运行时路径
  如果使用动态库版本，需要将pqxx.dll（vcpkg安装目录下的bin文件夹）和libpq.dll（PostgreSQL安装目录下的bin文件夹）复制到项目的输出目录，或者将这两个路径添加到系统环境变量PATH中。

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