RapidJSON解析失败常见原因包括未检查Parse状态、UTF-8 BOM干扰、空指针传入、类型不匹配访问、数组越界及大JSON内存问题；务必每次Parse后调用HasParseError()校验，严格进行类型与存在性检查，并合理配置内存分配器。
rapidjson::Document 解析失败时常见错误信息
直接调用 Parse 后访问字段却崩溃，大概率是没检查解析状态。RapidJSON 不抛异常，默认静默失败，HasParseError() 返回 true 时 GetParseError() 才给出具体提示，比如 "Invalid value." 或 "Missing a name for object member."。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 每次
Parse后必须立刻检查doc.HasParseError()，别跳过 - 确保输入字符串以
\0结尾（std::string.c_str()满足，但裸指针或内存池需手动保证） - UTF-8 BOM（
EF BB BF）会导致解析失败，读文件后应跳过前3字节（如果存在） - 不要传入空指针或未初始化的
char*，Parse(nullptr)行为未定义
嵌套对象与数组的类型安全访问
RapidJSON 的 Value 是联合体，字段存在 ≠ 类型匹配。比如用 ["name"] 取到一个值，再调 GetString() 前必须确认它是 kStringType，否则触发断言或未定义行为。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
IsObject()/IsArray()/IsString()等先校验类型，再取值 - 访问嵌套字段链（如
obj["data"]["items"][0]["id"]）前，逐层检查是否存在且类型正确 - 数组索引越界不会自动返回 null，
array.Size() == 0时访问[0]是未定义行为 - 推荐封装辅助函数，例如
SafeGetString(const Value& v, const char* key)，内部做HasMember+IsString双检
解析大 JSON 时内存与性能关键点
Document 默认使用栈式内存分配器（MemoryPoolAllocator），小文档很快，但解析几百 MB JSON 时可能因栈溢出崩溃，或因反复 realloc 拖慢速度。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 大文件优先用
ParseStream+FileReadStream，避免一次性加载全部字符串到内存 - 自定义分配器：传入
MemoryPoolAllocator并预设足够大的初始容量（如64 * 1024 * 1024） - 不需要修改文档时，用
const Document&引用传递，避免拷贝整个 DOM 树 - 频繁解析同结构 JSON，考虑用
SchemaValidator预校验格式，避免运行时反复判断字段类型
处理含中文、特殊字符或控制符的 JSON 字符串
RapidJSON 默认支持 UTF-8，但若源数据实际是 GBK/UTF-16，或含未转义的换行符、制表符、\0，解析会失败或截断。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认输入确实是合法 UTF-8：可用
utf8::is_valid()（需引入 utf8cpp）预检 - JSON 中的中文必须是 UTF-8 编码字节序列，不能是宽字符
L"中文"直接拼接 - 从 Windows API 或旧系统读取的字符串，可能含
\r\n或 BOM，解析前用std::replace清理或用rapidjson::UTF8显式指定编码 - 含
\uXXXX转义的中文，RapidJSON 自动解码，无需额外处理；但\UXXXXXXXX（32位）不支持，会报错
解析深层嵌套或动态结构时，最容易忽略的是类型检查顺序——先 HasMember 再 IsObject，再 HasMember……少一层检查，运行时就多一分崩溃风险。
