Windows平台下禁用MinGW编译器TLS(线程本地存储)方法咨询

MinGW-w64 32位工具链默认链接的CRT启动代码会自动生成3个TLS回调（TlsCallback_0/TlsCallback_1/TlsCallback_2），分别负责C++全局/线程局部对象构造析构、SEH异常初始化、CRT线程上下文清理，这部分逻辑嵌入CRT段中，当项目自定义DLL入口、存在自定义TLS逻辑、或TLS回调执行时机不满足预期时就会触发崩溃，MSVC编译正常是因为MSVC CRT对DLL场景的TLS回调注册逻辑和MinGW存在实现差异。

可根据项目实际场景选择以下方案解决：

方案1：通过链接开关直接禁用CRT自动TLS回调（优先尝试） #

新版本mingw-w64-i686提供了专门的链接选项关闭自动TLS注册，编译链接时添加以下参数即可：

• 编译阶段参数：-fno-threadsafe-statics（关闭静态变量线程安全初始化的TLS依赖）
• 链接阶段参数：-Wl,--disable-tls-callbacks

该方案不会破坏CRT的基础功能，仅移除自动注册的TLS回调，是兼容性最好的方案。

方案2：自定义入口点跳过CRT启动逻辑 #

如果项目不依赖MinGW CRT的自动初始化能力（无C++全局构造需求、自行实现内存/线程管理、不需要CRT内置异常处理），可以直接指定自定义入口，跳过CRT的TLS注册逻辑，链接时添加参数：
-nostartfiles -Wl,-e,_your_custom_entry@12
注意使用该参数时，DllMain的所有事件逻辑（进程/线程附加/分离）都需要自行实现，CRT不会自动执行任何初始化操作。

方案3：后处理剥离PE文件中的TLS段 #

旧版本MinGW-w64未提供--disable-tls-callbacks链接选项时，可以在构建完成后用工具链自带的objcopy工具移除TLS相关段：

objcopy --remove-section=.tls --remove-section=.tls$ target.dll
objcopy --set-checksum target.dll

第二条命令用于修正PE文件校验和，避免系统加载DLL时校验失败触发加载错误。

方案4：替换工具链线程模型变体 #

部分旧版Win32线程模型的i686 MinGW-w64存在TLS回调注册bug，会在DLL加载时重复执行回调访问非法内存，直接替换工具链为同版本的i686-posix-dwarf变体，无需修改代码重新编译即可解决问题。

注意：如果项目用到了thread_local线程局部变量、C++线程安全静态局部变量、MinGW SEH异常捕获能力，不要完全移除TLS回调，否则会出现变量未初始化、多线程竞争、异常无法捕获的问题，这类场景优先选择方案4替换工具链版本。

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