Android NDK开发自定义EGL函数出现Undefined symbol链接错误

1. 链接器找不到符号的原因 #

核心原因是C++名字修饰（Name Mangling）规则差异：

• EGL官方头文件中所有函数声明都被extern "C"包裹，因此A.cpp引用的eglGetNativeClientBufferANDROID是未经过C++名字修饰的纯函数名符号。
• B.cpp中定义该函数时没有加extern "C"修饰，按C++默认规则编译后，函数名会被加上参数类型、返回值类型相关的修饰后缀（即你看到的_Z31eglGetNativeClientBufferANDROIDPK15AHardwareBuffer），和A.cpp需要的符号名完全不一致，因此链接器无法匹配。
• eglCreateImageKHR能正常匹配，是因为系统libEGL.so导出的是C风格无修饰符号，和头文件声明的符号规则一致。

2. libEGL.so相关疑问解答 #

• _DYNAMIC是ELF格式文件的动态段标识，该段存储了动态链接所需的全部核心信息，包括导出/导入符号表、重定位条目、依赖的动态库列表、GOT/PLT表偏移等，是动态链接器加载so文件时必须解析的字段。
• libEGL.so导出的符号没有C类型修饰，是因为Android系统原生图形库的对外接口统一采用C语言ABI，要么是纯C实现，要么是C实现但导出时加了extern "C"声明，因此不会生成C++独有的名字修饰，保证不同语言开发的上层应用都能正常调用。

最优解决方案 #

不需要修改函数名，也不需要把实现塞到A.cpp中，只需要给B.cpp中的函数定义加上extern "C"修饰即可，示例代码：

// B.cpp 代码修改
#include <dlfcn.h>

extern "C" EGLClientBuffer eglGetNativeClientBufferANDROID(const struct AHardwareBuffer *buffer)
{
    // 可选：优先加载系统原生实现，高版本系统直接用官方实现，兼容性和性能更好
    static auto* real_func = reinterpret_cast<decltype(&eglGetNativeClientBufferANDROID)>(dlsym(RTLD_NEXT, "eglGetNativeClientBufferANDROID"));
    if (real_func) {
        return real_func(buffer);
    }
    // 低版本系统走自定义兼容逻辑
    return doSomething();
}

该方案优势：

1. 符号匹配完全符合EGL头文件的声明规则，链接不会报错
2. 高版本系统上会优先调用原生libEGL的实现，性能和兼容性更好
3. 后续要移除动态加载逻辑时，直接删除B.cpp中的该实现，切换到API 26+的libEGL链接即可，不需要修改其他业务代码

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