同时使用rapidjson与assimp导致rapidjson出现不可预期行为

问题背景 #

测试程序读取内容仅为{}的无效glTF文件时，Assimp::Importer::ReadFile触发RapidJSON的断言错误：

main: /home/sanderv/dev/twikbot-core/external/assimp/code/../contrib/rapidjson/include/rapidjson/document.h:1336: rapidjson::GenericValue::MemberIterator rapidjson::GenericValue<rapidjson::UTF8<> >::FindMember(const GenericValue<Encoding, SourceAllocator> &) [Encoding = rapidjson::UTF8<>, Allocator = rapidjson::MemoryPoolAllocator<>, SourceAllocator = rapidjson::MemoryPoolAllocator<>]: Assertion `IsObject()' failed.

移除后续document.HasMember("product")调用后程序可正常运行，调试发现调用FindMember时rapidjson::Document对象内存已损坏。

原因分析 #

1. Assimp内存越界：Assimp在解析无效glTF文件时，存在内存操作越界问题，覆盖了后续栈上分配的rapidjson::Document对象内存空间。
2. RapidJSON版本冲突：项目引入的RapidJSON与Assimp内置的RapidJSON版本不一致，导致内存分配/管理逻辑冲突，破坏了用户定义的Document对象。

解决方案 #

1. 升级Assimp版本 #

该问题属于Assimp的已知解析bug，升级到最新稳定版（如v5.3.1及以上）可直接修复无效glTF文件解析时的内存越界问题。

2. 调整变量定义顺序 #

将rapidjson::Document的定义移到Assimp::Importer之前，避免栈内存被Assimp的越界操作覆盖：

int main()
{
    std::cout << "testing document" << std::endl;
    rapidjson::Document document; // 提前定义Document

    std::cout << "reading test" << std::endl;
    Assimp::Importer importer;
    const aiScene *scene = importer.ReadFile("test.gltf", {});
    std::cout << "SUCCESS" << std::endl;

    std::cout << document.HasMember("product") << std::endl;

    return 0;
}

3. 启用Assimp错误日志排查 #

调用ReadFile后立即获取错误信息，确认Assimp解析时的具体问题：

const aiScene *scene = importer.ReadFile("test.gltf", {});
if (!scene) {
    std::cerr << "Assimp error: " << importer.GetErrorString() << std::endl;
    return 1;
}

4. 隔离RapidJSON版本 #

如果项目必须使用特定版本的RapidJSON，可通过编译选项隔离依赖：

• 编译Assimp时启用ASSIMP_USE_EXTERNAL_RAPIDJSON选项，禁用内置RapidJSON
• 确保项目与Assimp使用同一版本的RapidJSON库

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