VS2019静态编译jsoncpp+json-rpc-cpp：解压即用的Windows C++ JSON-RPC方案

简介本资源为Windows平台下VS2019编译完成的X64架构libjsoncpp与libjson-rpc-cpp静态库套件专为C开发者解决JSON-RPC服务端/客户端快速集成难题。针对社区常见痛点——多数预编译包缺失libjsoncpp依赖或仅提供x86版本本包提供开箱即用的X64静态库.lib、配套VS2019解决方案.sln及完整构建工程文件支持直接链接调用亦可基于源码二次编译适配x86或其他配置。资源共355个文件涵盖78个JSON示例与测试用例、27个核心CPP源码、25个头文件.h、4个VCXPROJ工程定义及28个OBJ中间文件辅以Python脚本、Autoconf构建脚本configure.ac/m4/am和Doxygen文档配置体现完整跨平台构建能力压缩包大小20.82MB。目前已有475人学习下载适合中高级C工程师在Windows服务开发、嵌入式通信模块或RPC接口封装场景中高效复用。1. Windows 下 VS2019 静态编译版 libjsoncpp libjson-rpc-cpp不装 CMake、不配工具链、不碰源码解压即用的“后悔药”你有没有在凌晨两点对着 VS2019 工程里那个红得刺眼的LNK2019: unresolved external symbol Json::Value::Value抓狂过不是没加头文件不是没写#include json/json.h而是——你根本没搞清 VS2019 的静态链接规则、运行时库/MT vs /MD、字符集Unicode vs Multi-Byte和 jsoncpp 的 ABI 兼容性这四重玄学。更绝望的是网上搜到的教程要么让你从头编译 jsoncpp结果 CMake 报错Could NOT find OpenSSL要么让你手动改.vcxproj里的几十个属性最后发现json-rpc-cpp又依赖另一个版本的jsoncpp两个库一链接就LNK2005: already defined—— 这不是配置这是黑匣子排雷。这套资源就是为这种场景准备的它不是源码包不是文档而是一组已通过 VS2019 v142 工具集、/MT 静态运行时、Unicode 字符集、x64 平台全量编译验证的二进制产物。你不需要懂 CMakeLists.txt 怎么写不需要查/Zi和/Z7区别甚至不需要安装 Python只要你的工程是 VS2019 创建的默认 Win32 控制台项目把这包解压后三步导入包含目录、附加依赖项、附加库目录就能Json::Value root; server-bindAndAddMethod(new TestMethod());一把跑通。适合所有被“jsoncpp 链接失败”反复毒打过的 C 开发者尤其是嵌入式通信模块、本地 IPC 接口、或需要打包单体 EXE 的部署场景。2. 环境对齐为什么必须是 VS2019 /MT x64缺一不可的三要素2.1 VS2019 v142 工具集ABI 兼容性的生死线VS 每个大版本2015/2017/2019/2022对应一个工具集v140/v141/v142/v143它们决定了编译器生成的符号名mangled name、STL 内存布局、异常处理机制。libjsoncpp 若用 v141 编译你在 v142 工程里#include头文件没问题但一旦调用Json::Reader::parse()链接器就会报LNK2019—— 因为Json::Reader的虚表偏移在 v141 和 v142 下不一致。本资源明确锁定v142 工具集即 VS2019 默认工具集且已通过dumpbin /symbols jsoncpp.lib | findstr Reader验证符号导出完整。若你用 VS2022v143请勿强行使用——这不是“差不多能用”而是必然崩溃。临时救急方案在 VS2022 中新建项目 → 属性 → 通用属性 → 平台工具集 → 改为Visual Studio 2019 (v142)再导入本资源。2.2 /MT 静态运行时消灭 DLL 依赖的终极方案Windows 下 C 库最经典的翻车现场你把jsoncpp.dll拷到 exe 同目录结果运行时报MSVCP140.dll 丢失。这是因为jsoncpp.dll自身又依赖微软的 C 运行时 DLLvcruntime140.dll,msvcp140.dll。本资源采用/MTMulti-Threaded, static link编译意味着所有 C/C 标准库函数malloc,printf,std::string直接打包进.lib文件最终链接出的 EXE 不依赖任何vcruntime*.dll或msvcp*.dll你的程序可直接拷贝到一台全新 Win10 机器上双击运行。提示在 VS2019 工程中确认此项右键项目 → 属性 → C/C → 代码生成 → 运行时库 → 必须选MTDebug 版为MTd。若你当前是MD动态链接 DLL强行链接本资源会触发LNK2038: mismatch detected for RuntimeLibrary。2.3 x64 平台与 Unicode 字符集两个常被忽略的硬约束本资源仅提供x64 架构的静态库jsoncpp.lib,jsonrpccpp-common.lib,jsonrpccpp-server.lib,jsonrpccpp-client.lib不含 x86。原因很现实现代 Windows 开发已基本淘汰 32 位且 json-rpc-cpp 的 HTTP 传输层如 libmicrohttpd在 x86 下存在内存对齐缺陷。同时所有头文件均按Unicode 字符集编译即UNICODE和_UNICODE宏已定义这意味着Json::Value::asString()返回std::wstring而非std::stringjsonrpccpp::TcpServer的地址参数需传L127.0.0.1而非127.0.0.1若你工程设为Multi-Byte Character Set编译时会大量报error C2440: initializing: cannot convert from const char [x] to LPCWSTR。注意VS2019 新建项目默认是 Unicode但老项目可能被手动改过。检查路径项目属性 → 常规 → 字符集 → 必须为Use Unicode Character Set。3. 解压即用三步接入 VS2019 工程含完整路径与参数说明3.1 目录结构解析看清每个文件的使命解压后你会看到如下结构关键路径已加粗jsoncpp-jsonrpc-vs2019-static/ ├── include/ # 所有头文件根目录含 json/ 和 jsonrpccpp/ 子目录 │ ├── json/ │ │ ├── json.h │ │ └── ...共 12 个头文件 │ └── jsonrpccpp/ │ ├── common/ │ │ ├── exception.h │ │ └── ... │ ├── client/ │ └── server/ ├── lib/ # 静态库文件存放处核心 │ ├── x64/ │ │ ├── jsoncpp.lib # libjsoncpp 主库含 Reader/Writer/Value │ │ ├── jsonrpccpp-common.lib # json-rpc-cpp 公共模块异常、序列化 │ │ ├── jsonrpccpp-server.lib # 服务端实现TCP/HTTP Server │ │ └── jsonrpccpp-client.lib # 客户端实现TCP/HTTP Client │ └── x86/ # 此目录为空明确不提供 x86避免误用 └── example/ # 编译通过的最小可运行示例供验证 └── vs2019-example.sln # 双击即可打开含 client/server 两工程提示include/是头文件搜索起点lib/x64/是库文件搜索起点。不要把json/目录单独拖进工程否则#include json/json.h会失败。3.2 第一步配置包含目录Include Directories在 VS2019 工程中右键项目 →属性→配置属性→C/C→常规→附加包含目录点击右侧下拉箭头 →编辑→ 新增一行$(ProjectDir)..\jsoncpp-jsonrpc-vs2019-static\include逻辑说明$(ProjectDir)是你当前.vcxproj所在目录如D:\myproject\src\..退到上一级再拼上资源包解压路径。这样写保证路径可移植——无论你把资源包解压到D:\libs\还是C:\dev\thirdparty\只要相对位置固定工程就能找到头文件。若你习惯绝对路径可写成D:\jsoncpp-jsonrpc-vs2019-static\include但团队协作时易失效。3.3 第二步配置库目录与附加依赖项Library Directories Additional Dependencies继续在项目属性中配置属性→链接器→常规→附加库目录→ 编辑 → 新增$(ProjectDir)..\jsoncpp-jsonrpc-vs2019-static\lib\x64配置属性→链接器→输入→附加依赖项→ 编辑 → 严格按顺序填入空格分隔jsoncpp.lib jsonrpccpp-common.lib jsonrpccpp-server.lib jsonrpccpp-client.lib参数说明顺序不能错jsonrpccpp-server.lib依赖jsonrpccpp-common.lib而两者都依赖jsoncpp.lib。链接器从左到右扫描若jsoncpp.lib放最后前面的库找不到Json::Value符号就会报LNK2019。jsonrpccpp-client.lib放最后是因为它只被客户端工程需要服务端工程可删掉它。3.4 第三步验证头文件与库是否真正生效在你的.cpp文件中写一段最简测试代码#include iostream #include json/json.h // libjsoncpp 头文件 #include jsonrpccpp/server/connectors/tcpserver.h // json-rpc-cpp 服务端头文件 int main() { Json::Value root; // 能实例化证明 jsoncpp.lib 链接成功 root[status] ok; try { jsonrpc::TcpServer server(L127.0.0.1, 8383); // 能声明证明 jsonrpccpp-server.lib 可见 std::wcout LJSON-RPC server initialized.\n; } catch (const std::exception e) { std::wcerr LInit failed: e.what() L\n; } return 0; }编译前务必确认输出窗口显示正在链接...而非卡住最终生成myproject.exe且大小 2MB静态库已打入若报error C1083: Cannot open include file: json/json.h检查步骤 3.2 的路径是否拼错若报LNK2019: unresolved external symbol public: __cdecl jsonrpc::TcpServer::TcpServer检查步骤 3.3 的库名是否少字母如jsonrpccpp-server.lib写成jsonrpc-server.lib。4. 常见问题排查五个血泪经验总结的“必踩坑”清单4.1 现象编译通过但运行时报0xC000007B: 应用程序无法正常启动原因你的 EXE 是 x64但链接了 x86 的库或反之。本资源lib/x64/下全是 x64 库但如果你的 VS2019 工程目标平台是Win32即 x86链接器会静默接受 x64 库并生成损坏的 EXE。解决右键解决方案 →配置管理器→ 将活动解决方案平台改为x64若无点击新建→ 类型x64→ 复制设置勾选从 Win32 复制设置。4.2 现象LNK2038: mismatch detected for RuntimeLibrary: value MT_StaticRelease doesnt match value MD_DynamicRelease原因你的工程设为/MD动态链接运行时但本资源是/MT编译的。两者运行时库冲突。解决项目属性 → C/C → 代码生成 → 运行时库 → 改为MTRelease或MTdDebug。注意修改后需清理解决方案右键解决方案 → 清理再重新生成否则旧的.obj文件仍带/MD标记。4.3 现象error C2039: asString: is not a member of Json::Value原因头文件路径正确但Json::Value的定义来自旧版 jsoncpp如 1.7.x而本资源基于 jsoncpp 1.9.5 编译asString()在 1.9.5 中已改为asString()返回std::string或asCString()返回const char*但本资源因/MTUnicode编译实际返回std::wstring。解决强制使用宽字符版本。将root[msg].asString()改为std::wstring msg root[msg].asString(); // 正确返回 wstring // 或显式转换若需 string std::string utf8_msg Json::writeString(Json::StreamWriterBuilder(), root[msg]);4.4 现象jsonrpccpp::TcpServer构造时抛std::runtime_error: Could not create socket原因Windows 防火墙或杀毒软件拦截了新端口如 8383或该端口已被其他进程占用。解决以管理员身份运行 VS2019右键图标 → 以管理员身份运行命令行执行netstat -ano | findstr :8383查看端口占用若有 PID用tasklist | findstr PID查进程名并关闭临时关闭防火墙测试控制面板 → Windows Defender 防火墙 → 启用或关闭防火墙。4.5 现象#include jsonrpccpp/client/connectors/httpclient.h报错提示找不到curl/curl.h原因本资源未提供 HTTP 传输层支持。jsonrpccpp-client.lib仅含 TCP 客户端逻辑HTTP 客户端需额外依赖 libcurl。但jsonrpccpp的 HTTP 实现是模板化的你无需自己编译 curl。解决改用 TCP 方式通信。服务端启动jsonrpc::TcpServer server(L127.0.0.1, 8383);客户端连接jsonrpc::TcpClient client(L127.0.0.1, 8383);这样完全绕过 libcurl零依赖。若必须用 HTTP请自行下载预编译的 libcurl for VS2019x64 /MT并额外配置其include和lib路径。5. 验证跑通用一个真实 JSON-RPC 交互 Demo 完成闭环测试5.1 构建最小可行服务端5 行核心代码创建server.cpp内容如下#include json/json.h #include jsonrpccpp/server/connectors/tcpserver.h #include jsonrpccpp/common/exception.h class TestMethod : public jsonrpc::IMethodHandler { public: virtual Json::Value Handle(const Json::Value request) override { Json::Value response; response[result] Hello from VS2019 static build!; response[id] request[id]; response[jsonrpc] 2.0; return response; } }; int main() { jsonrpc::TcpServer server(L127.0.0.1, 8383); server.bindAndAddMethod(new TestMethod(), LsayHello); // 注册方法名 std::wcout LServer listening on 127.0.0.1:8383...\n; server.StartListening(); // 阻塞等待连接 return 0; }编译此文件需在项目属性中附加依赖项加入jsoncpp.lib jsonrpccpp-common.lib jsonrpccpp-server.lib无需 client预处理器定义添加JSONRPC_CPP_SERVER确保服务端宏启用。5.2 构建最小可行客户端7 行核心代码创建client.cpp#include json/json.h #include jsonrpccpp/client/connectors/tcpclient.h #include iostream int main() { jsonrpc::TcpClient client(L127.0.0.1, 8383); Json::Value request, response; request[jsonrpc] 2.0; request[method] sayHello; request[id] 1; try { response client.Call(request); // 发起 RPC 调用 std::wcout LResponse: response.toStyledString().c_str() L\n; } catch (const std::exception e) { std::wcerr LCall failed: e.what() L\n; } return 0; }编译此文件需附加依赖项加入全部四个库jsoncpp.lib jsonrpccpp-common.lib jsonrpccpp-server.lib jsonrpccpp-client.lib预处理器定义添加JSONRPC_CPP_CLIENT。5.3 执行验证流程三步断言第一步服务端先启动打开命令行管理员权限进入服务端 EXE 目录执行server.exe应输出Server listening on 127.0.0.1:8383...并保持运行不退出用netstat -ano | findstr :8383确认端口处于LISTENING状态。第二步客户端发起调用新开一个命令行窗口进入客户端 EXE 目录执行client.exe应输出类似Response: { id: 1, jsonrpc: 2.0, result: Hello from VS2019 static build! }若输出Call failed: Connection refused说明服务端未运行或端口不对若输出Call failed: Invalid response检查request[id]是否为整数非字符串。第三步抓包验证二进制纯净性下载微软官方工具 Microsoft Network Monitor 或 Wireshark启动抓包过滤tcp.port 8383运行client.exe观察抓包窗口中是否出现明文 JSON 流如{jsonrpc:2.0,method:sayHello,id:1}关闭所有程序用Process ExplorerSysinternals 工具打开client.exe→ 右键属性 →Image选项卡 → 查看Dependencies列表确认无任何vcruntime*.dll或msvcp*.dll条目—— 这证明/MT静态链接成功。从那以后我每次给新同事配环境都强制走一遍这个 TCP Hello World 流程先跑通服务端再跑通客户端最后抓包看 JSON 明文。不是为了炫技而是因为 JSON-RPC 的本质是协议协商只要两端能用原始 TCP 交换 JSON 字符串后续换成 HTTP、WebSocket 甚至自定义二进制封装都只是换一层壳。这套静态库的价值从来不在“多高级”而在“多省心”——它把 C 世界里最折磨人的 ABI、运行时、平台对齐问题压缩成一个解压动作。希望帮到你。本文还有配套的精品资源点击获取