添加ASan编译链接标志后出现多重定义错误的原因排查

问题背景 #

在大型代码库中排查内存损坏问题，原有Makefile编译可正常生成二进制文件。添加以下编译/链接标志启用ASan后，链接阶段出现多重定义错误：

• 编译标志：-g -fsanitize=address -fno-omit-frame-pointer -fno-common
• 链接标志：-fsanitize=address（也曾尝试-lasan）

困惑点 #

• 明明存在多重定义，为何无ASan标志时编译未报错？
• ASan官方文档中未找到相关问题说明

错误示例 #

path/to/file/hdr.h:132: multiple definition of myDataTable_type' path/to/file/hdr.h:132: first defined here path/to/obj/file/obj.o: multiple definition of __odr_asan.myDataTable_type'

使用GCC版本：gcc (GCC) 8.4.1 20200928 (Red Hat 8.4.1-1)

原因分析 #

1. 默认编译的宽松兼容：GCC默认模式下，对未初始化的全局变量会采用「公共符号（common symbol）」机制，多个目标文件中的重复定义会被自动合并，不会触发链接错误。但ASan启用后会严格执行C/C++的ODR（单一定义规则），直接暴露原本被掩盖的问题。
2. ASan的符号包装机制：ASan会对全局变量进行包装，生成__odr_asan.xxx这类带前缀的符号。如果头文件中直接定义了全局变量（而非仅用extern声明），每个包含该头文件的源文件都会生成对应的ASan包装符号，链接时必然冲突。
3. -fno-common的放大作用：你添加的-fno-common标志会禁用公共符号机制，强制所有全局变量定义必须唯一。没有ASan时，可能还能靠公共符号合并蒙混过关，加上ASan后双重约束直接触发错误。

解决步骤 #

1. 修正头文件变量声明：找到hdr.h中myDataTable_type的定义，将头文件中的直接定义（如Type myDataTable_type;）改为extern声明（extern Type myDataTable_type;），真正的定义移到单个源文件（比如对应的.c/.cpp）中。
2. 检查全局变量的作用域：如果是需要在多个文件共享的变量，必须严格遵循「头文件声明，源文件定义」的规则；如果是仅在单个文件使用的变量，加上static限制作用域，避免跨文件的符号冲突。
3. 排查重复包含问题：确保头文件有正确的包含保护（#ifndef/#define/#endif或#pragma once），虽然这不能直接解决多重定义，但能避免头文件被重复包含导致的冗余定义。

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