nlohmann/json实战：从‘Hello World’到解析B站API返回的复杂数据结构
用nlohmann/json实战解析B站API：从网络请求到结构化数据处理
第一次尝试用C++处理B站API返回的JSON数据时，我被那些嵌套五六层的对象和随时可能为空的字段搞得晕头转向。作为一个主要使用C++进行本地开发的程序员，突然要处理这种动态网络数据，确实需要一套趁手的工具和方法。这就是为什么nlohmann/json库会成为现代C++开发者的首选——它让JSON解析变得像操作原生C++对象一样自然。
本文将带你从零开始，构建一个完整的B站视频信息解析工具。不同于简单的本地文件解析，我们会重点解决网络编程中的实际问题：如何处理内存中的JSON字符串、应对复杂的嵌套结构、处理可能缺失的字段，最终将这些数据转换为类型安全的C++对象。无论你是想开发B站数据分析工具，还是单纯想学习现代C++处理JSON的最佳实践，这篇文章都能提供实用的解决方案。
1. 环境准备与基础配置
1.1 引入必要的库
在开始之前，我们需要准备两个核心库：nlohmann/json用于JSON解析，以及一个HTTP客户端库来获取API数据。虽然C++标准库没有内置HTTP客户端功能，但libcurl是一个广泛使用的选择。
首先，在你的项目中包含必要的头文件：
#include <nlohmann/json.hpp> #include <curl/curl.h> #include <string> #include <iostream>对于nlohmann/json，它是一个header-only的库，只需包含头文件即可使用。为了方便起见，我们通常会添加一个类型别名：
using json = nlohmann::json;1.2 配置libcurl
libcurl需要一些初始设置。我们可以创建一个简单的辅助函数来初始化并清理libcurl资源：
class CurlHandle { public: CurlHandle() { curl_global_init(CURL_GLOBAL_ALL); handle = curl_easy_init(); } ~CurlHandle() { if(handle) curl_easy_cleanup(handle); curl_global_cleanup(); } CURL* get() { return handle; } private: CURL* handle; };提示：使用RAII(Resource Acquisition Is Initialization)模式管理libcurl资源可以确保即使在发生异常时也能正确释放资源，这是C++的最佳实践。
2. 获取B站API数据
2.1 构建API请求
B站提供了多种公开API，我们以获取视频信息的API为例。这个API通常需要视频的BV号作为参数。
首先，我们需要一个回调函数来处理从网络接收到的数据：
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) { size_t total_size = size * nmemb; output->append(static_cast<char*>(contents), total_size); return total_size; }然后，我们可以构建一个函数来获取视频信息：
std::string fetch_bilibili_video_info(const std::string& bvid) { std::string response_string; CurlHandle curl; if(curl.get()) { std::string url = "https://api.bilibili.com/x/web-interface/view?bvid=" + bvid; curl_easy_setopt(curl.get(), CURLOPT_URL, url.c_str()); curl_easy_setopt(curl.get(), CURLOPT_WRITEFUNCTION, WriteCallback); curl_easy_setopt(curl.get(), CURLOPT_WRITEDATA, &response_string); CURLcode res = curl_easy_perform(curl.get()); if(res != CURLE_OK) { throw std::runtime_error("CURL request failed: " + std::string(curl_easy_strerror(res))); } } return response_string; }2.2 处理API响应
B站API返回的JSON结构通常比较复杂。一个典型的视频信息响应可能包含以下主要部分：
- 基本信息（标题、作者、发布时间等）
- 统计信息（播放量、弹幕数、收藏数等）
- 分P信息（如果视频有多个部分）
- 标签信息
- 推荐视频列表
我们可以先简单地打印出原始JSON，看看结构如何：
std::string bvid = "BV1GJ411x7h7"; // 示例BV号 std::string api_response = fetch_bilibili_video_info(bvid); json j = json::parse(api_response); std::cout << j.dump(2) << std::endl; // 使用dump(2)进行漂亮打印，缩进为2个空格3. 解析复杂JSON结构
3.1 基本字段解析
让我们从解析视频的基本信息开始。B站API通常会在"data"字段中包含主要信息，外层是元信息如状态码。
try { if(j.contains("code") && j["code"].get<int>() == 0) { auto& data = j["data"]; std::string title = data["title"]; std::string author = data["owner"]["name"]; int duration = data["duration"]; std::cout << "视频标题: " << title << std::endl; std::cout << "UP主: " << author << std::endl; std::cout << "时长: " << (duration / 60) << "分" << (duration % 60) << "秒" << std::endl; } else { std::cerr << "API请求失败: " << j["message"].get<std::string>() << std::endl; } } catch(const json::exception& e) { std::cerr << "JSON解析错误: " << e.what() << std::endl; }3.2 处理嵌套对象和数组
B站视频的分P信息是一个数组，每个元素包含分P标题、时长等信息。我们可以这样处理：
if(data.contains("pages") && data["pages"].is_array()) { std::cout << "\n分P列表:" << std::endl; for(auto& page : data["pages"]) { std::string part = page["part"]; int duration = page["duration"]; std::cout << "- " << part << " (" << duration << "秒)" << std::endl; } }统计信息通常位于单独的字段中，我们可以将其提取到一个结构体中：
struct VideoStats { int view; // 播放量 int danmaku; // 弹幕数 int reply; // 评论数 int favorite; // 收藏数 int coin; // 硬币数 int share; // 分享数 int like; // 点赞数 }; // 为VideoStats定义from_json函数 void from_json(const json& j, VideoStats& stats) { j.at("view").get_to(stats.view); j.at("danmaku").get_to(stats.danmaku); j.at("reply").get_to(stats.reply); j.at("favorite").get_to(stats.favorite); j.at("coin").get_to(stats.coin); j.at("share").get_to(stats.share); j.at("like").get_to(stats.like); } // 使用方式 VideoStats stats = data["stat"]; std::cout << "\n播放量: " << stats.view << std::endl;3.3 处理可能缺失的字段
API返回的JSON中，某些字段可能在某些情况下缺失。nlohmann/json提供了几种安全访问方式：
// 方法1: 使用contains检查 if(data.contains("subtitle") && data["subtitle"].is_object()) { auto& subtitle = data["subtitle"]; // 处理字幕信息 } // 方法2: 使用value()带默认值 std::string bvid = data.value("bvid", ""); std::string aid = data.value("aid", ""); // 方法3: 使用try-catch try { auto& season_info = data.at("ugc_season"); // 处理合集信息 } catch(const json::out_of_range&) { // 字段不存在时的处理 }4. 高级技巧与性能优化
4.1 自定义类型转换
对于复杂的数据结构，我们可以定义自定义的from_json函数来实现自动转换。例如，处理视频标签：
struct VideoTag { int tag_id; std::string tag_name; bool is_activity; }; void from_json(const json& j, VideoTag& tag) { j.at("tag_id").get_to(tag.tag_id); j.at("tag_name").get_to(tag.tag_name); tag.is_activity = j.value("is_activity", false); } // 使用方式 std::vector<VideoTag> tags; if(data.contains("tags") && data["tags"].is_array()) { tags = data["tags"].get<std::vector<VideoTag>>(); }4.2 处理大型JSON数据
当处理非常大的JSON响应时（如包含大量推荐视频），我们可以使用json::parse的SAX接口来减少内存使用：
class VideoInfoSax : public json::json_sax_t { public: bool key(std::string& val) override { current_key = val; return true; } bool string(std::string& val) override { if(current_key == "title") { title = val; } return true; } bool number_integer(number_integer_t val) override { if(current_key == "view") { view_count = val; } return true; } std::string title; int view_count = 0; private: std::string current_key; }; // 使用SAX解析器 VideoInfoSax sax; json::sax_parse(api_response, &sax); std::cout << "视频标题: " << sax.title << ", 播放量: " << sax.view_count << std::endl;4.3 缓存与性能考虑
频繁调用API可能会遇到性能瓶颈和速率限制。我们可以实现一个简单的缓存机制：
#include <unordered_map> #include <chrono> class VideoCache { public: struct CacheEntry { json data; std::chrono::system_clock::time_point expiry; }; json get_video_info(const std::string& bvid) { auto it = cache.find(bvid); if(it != cache.end() && std::chrono::system_clock::now() < it->second.expiry) { return it->second.data; } std::string response = fetch_bilibili_video_info(bvid); json data = json::parse(response); cache[bvid] = { data, std::chrono::system_clock::now() + std::chrono::minutes(5) // 缓存5分钟 }; return data; } private: std::unordered_map<std::string, CacheEntry> cache; };5. 错误处理与调试技巧
5.1 常见错误处理
处理网络API时，可能会遇到各种错误情况：
try { std::string response = fetch_bilibili_video_info(bvid); json j = json::parse(response); if(j["code"] != 0) { handle_api_error(j["code"], j.value("message", "")); return; } // 正常处理数据... } catch(const json::parse_error& e) { std::cerr << "JSON解析失败: " << e.what() << std::endl; std::cerr << "错误位置: " << e.byte << std::endl; } catch(const json::out_of_range& e) { std::cerr << "JSON字段缺失: " << e.what() << std::endl; } catch(const std::exception& e) { std::cerr << "发生错误: " << e.what() << std::endl; }5.2 调试复杂JSON结构
当处理特别复杂的JSON时，可以使用一些辅助方法来理解结构：
// 打印所有键 for(auto& [key, value] : j["data"].items()) { std::cout << key << ": " << value.type_name() << std::endl; } // 检查特定路径是否存在 bool has_related = json::json_pointer("/data/related").contains(j); // 使用json_pointer访问深层嵌套数据 try { auto first_related_title = j[json::json_pointer("/data/related/0/title")]; std::cout << "第一个推荐视频: " << first_related_title << std::endl; } catch(...) { // 处理路径不存在的情况 }5.3 单元测试与Mock数据
为了可靠地测试JSON解析逻辑，可以使用本地Mock数据：
std::string mock_data = R"({ "code": 0, "data": { "title": "测试视频", "owner": { "name": "测试UP主" }, "stat": { "view": 10000, "danmaku": 500 } } })"; json test_j = json::parse(mock_data); VideoStats test_stats = test_j["data"]["stat"]; assert(test_stats.view == 10000);6. 构建完整应用示例
现在，我们把所有部分组合起来，构建一个完整的B站视频信息查询工具：
#include <nlohmann/json.hpp> #include <curl/curl.h> #include <string> #include <iostream> #include <vector> #include <iomanip> using json = nlohmann::json; // 数据结构定义 struct VideoStats { /* 同上 */ }; struct VideoTag { /* 同上 */ }; struct VideoPage { /* 分P信息 */ }; struct VideoInfo { /* 完整视频信息 */ }; // 辅助函数定义 size_t WriteCallback(/* 同上 */); std::string fetch_bilibili_video_info(/* 同上 */); // from_json定义 void from_json(const json& j, VideoStats& stats) { /* 同上 */ }; void from_json(const json& j, VideoTag& tag) { /* 同上 */ }; void from_json(const json& j, VideoPage& page) { /* 同上 */ }; void from_json(const json& j, VideoInfo& info) { /* 同上 */ }; int main(int argc, char** argv) { if(argc < 2) { std::cerr << "用法: " << argv[0] << " <BV号>" << std::endl; return 1; } std::string bvid = argv[1]; try { std::string response = fetch_bilibili_video_info(bvid); json j = json::parse(response); if(j["code"] != 0) { std::cerr << "错误: " << j["message"] << std::endl; return 1; } VideoInfo video = j["data"]; // 打印视频信息 std::cout << "\n《" << video.title << "》\n"; std::cout << "UP主: " << video.owner.name << "\n\n"; std::cout << "基本信息:\n"; std::cout << " - 发布时间: " << std::put_time(&video.pubdate, "%Y-%m-%d %H:%M") << "\n"; std::cout << " - 分区: " << video.tname << "\n"; std::cout << " - 标签: "; for(const auto& tag : video.tags) { std::cout << tag.tag_name << " "; } std::cout << "\n\n"; std::cout << "统计数据:\n"; std::cout << " - 播放: " << video.stat.view << "\n"; std::cout << " - 弹幕: " << video.stat.danmaku << "\n"; std::cout << " - 点赞: " << video.stat.like << "\n"; std::cout << " - 收藏: " << video.stat.favorite << "\n\n"; if(!video.pages.empty()) { std::cout << "分P列表:\n"; for(const auto& page : video.pages) { std::cout << " - " << page.part << " (" << page.duration << "秒)\n"; } } } catch(const std::exception& e) { std::cerr << "发生错误: " << e.what() << std::endl; return 1; } return 0; }在实际项目中，我发现处理B站API返回的JSON数据时，最常遇到的挑战是字段结构的变化和某些字段的缺失。通过定义明确的数据结构和合理的错误处理，可以构建出健壮的视频信息处理工具。对于更复杂的应用，还可以考虑添加视频下载、弹幕分析等功能，但核心的JSON处理模式都是类似的。