g++11的unordered_map与gcc-11之前版本不兼容问题排查

问题描述 #

将项目GCC版本从7.5升级至11.4后，运行时出现异常：调用由GCC7.5编译的库中类成员函数时，类内private成员std::unordered_map的键值全部错误——构造函数已向容器插入数据，但成员函数读取时键完全不符合预期。

复现步骤 #

在Ubuntu 18.04环境下，可通过以下代码复现问题：

代码文件 #

// kernel.h
#include <memory>
#include <string>
#include <unordered_map>

struct Kernel {
  Kernel();

  void Print();

 private:
  std::unordered_map<int, std::shared_ptr<int>> mapping_;
};

// kernel.cc
#include <iostream>
#include "kernel.h"

Kernel::Kernel() { 
        mapping_[5] = std::make_shared<int>(233); 
        mapping_[6] = std::make_shared<int>(234);
        mapping_[7] = std::make_shared<int>(235);
        mapping_[8] = std::make_shared<int>(236);
}

void Kernel::Print() {
  for (auto &[key, value] : mapping_) {
    std::cout << key << " " << value << " " << *value << std::endl;
  }
}

// test.cpp
#include "kernel.h"

int main() {
  Kernel kernel;
  kernel.Print();

  return 0;
}

编译与执行命令 #

# 用GCC7编译库文件
g++ kernel.cc -o kernel.o -c --std=c++17
# 用GCC11编译主程序并链接库文件（此顺序会触发异常）
g++-11 test.cpp kernel.o -o test --std=c++17
# 执行程序
./test

运行后会输出键值异常的结果。

关键现象 #

• GCC7_{GCC10之间任意交叉编译组合均无问题；但用GCC7}GCC10编译kernel.o，搭配GCC11~GCC13编译test.cpp时，问题必现。
• 调整编译参数顺序，将kernel.o放在test.cpp之前，结果恢复正常：

g++ kernel.cc -o kernel.o -c --std=c++17
g++-11 -o test kernel.o test.cpp --std=c++17

原因分析 #

GCC11对std::unordered_map的内部实现做了ABI（应用二进制接口）变更，导致其内存布局、内部函数符号与GCC10及更早版本不兼容：

1. 当用高版本GCC编译主程序时，链接器会优先选择高版本libstdc++中的std::unordered_map相关符号；而库文件是用低版本GCC编译的，构造unordered_map时使用的是旧版本的内存布局。
2. 主程序调用成员函数读取容器时，用的是高版本的访问逻辑，与旧版本的内存布局不匹配，最终导致键值读取错乱。
3. 调整编译顺序后，链接器会优先加载库文件依赖的旧版本libstdc++符号，使得构造和访问容器使用的是同一版本的实现，因此恢复正常。

解决方法 #

1. 统一编译版本：将所有代码（包括库和主程序）切换到同一版本的GCC编译，推荐统一升级到GCC11.4或更高稳定版本，从根源避免ABI不兼容问题。
2. 调整链接顺序：在编译命令中将低版本GCC编译的目标文件/库放在最前面，确保链接器优先选择其依赖的旧版本libstdc++符号。
3. 静态链接标准库：编译时添加-static-libstdc++参数，将libstdc++静态链接到程序中，避免动态链接时的版本冲突，但需注意静态链接带来的程序体积增大等问题。

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