使用g++编译static inline thread_local变量时出现链接错误

问题场景 #

使用CLion搭配MinGW GCC 9.3（Windows平台），以C++20标准编译代码时出现链接错误：

multiple definition of `TLS init function for StructOuter::problemStruct' ... collect2.exe: error: ld returned 1 exit status ninja: build stopped: subcommand failed

涉及的代码文件如下：

lib.h #

#ifndef lib
#define lib

struct StructOuter{
    struct StructInner{
        int a;
        StructInner(int aa) {
            a = aa;
        }
    };

    static inline thread_local StructInner problemStruct{3};
};

#endif

other.cpp #

#include "lib.h"

main.cpp #

#include "lib.h"

int main() {
    StructOuter t = StructOuter{};
    return t.problemStruct.a;
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.25)
project(proj)

set(CMAKE_CXX_STANDARD 20)

add_executable(proj main.cpp other.cpp)

已知补充信息：

• static inline本应避免跨翻译单元的多重定义问题
• 移除thread_local后编译正常
• 切换为Windows下clang64编译器可正常编译

根本原因 #

这是MinGW GCC 9.x版本针对Windows平台的已知bug：

• C++17及后续标准明确规定，static inline变量（包括类静态成员）在多个翻译单元中被实例化时，链接器需将其合并为单一实例，不会产生多重定义冲突。
• 但MinGW GCC 9.x在处理Windows TLS（线程本地存储）的初始化逻辑时，没有正确将TLS初始化函数标记为inline，导致每个包含lib.h的翻译单元（main.cpp、other.cpp）都会生成一份独立的初始化函数定义，链接时就触发了多重定义错误。
• Clang对Windows TLS的实现符合标准，因此不会出现该问题；移除thread_local后，变量无需生成特殊的TLS初始化函数，自然也不会触发bug。

无需修改头文件的解决办法 #

1. 升级MinGW GCC版本：该bug在GCC 10及以上版本中已被修复，升级到较新版本即可彻底解决问题。
2. 临时添加链接选项（不推荐长期使用）：在CMakeLists.txt中添加链接器选项，强制忽略多重定义的符号，仅作为临时应急方案：

target_link_options(proj PRIVATE -Wl,--allow-multiple-definition)

3. 继续使用Clang编译器：既然Windows下clang64可正常编译，直接沿用该编译器也是稳定的解决方案。

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