静态链接C++程序时出现Multiple definition错误的求助

问题重现 #

我尝试编译以下基于Boost.Asio的C++代码：

main.cpp

#include "server.hpp"

int main()
{

}

server.hpp

#ifndef SERVER_HPP
#define SERVER_HPP

#include <boost/asio.hpp>

class Server
{
    boost::asio::io_context context;

    void listen();
};

#endif

server.cpp

#include "server.hpp"

void Server::listen()
{
    static boost::asio::ip::tcp::acceptor acceptor {
        context,
        {boost::asio::ip::tcp::v4(), 1000}
    };
}

使用GCC 13.1执行编译命令：

g++ -static-libgcc -static-libstdc++ -std=c++23 .\main.cpp .\server.cpp -lws2_32

出现链接错误：

D:/Programmi/msys64/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.1.0/../../../../x86_64-w64-mingw32/bin/ld.exe: D:/Programmi/msys64/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.1.0/../../../../lib\libstdc++.a(tinfo.o):(.text$_ZNKSt9type_infoeqERKS_+0x0): multiple definition of `std::type_info::operator==(std::type_info const&) const'; C:\Users\jayok\AppData\Local\Temp\cc4dUKMC.o:server.cpp:(.text$_ZNKSt9type_infoeqERKS_[_ZNKSt9type_infoeqERKS_]+0x0): first defined here
collect2.exe: error: ld returned 1 exit status

已知可行场景：

• 将listen函数体设为空时编译成功
• 移除-static-libgcc -static-libstdc++参数改用动态链接时编译成功

错误原因 #

这是静态链接模式下的符号冲突问题：当代码实例化boost::asio::ip::tcp::acceptor时，Boost.Asio相关代码会引入包含std::type_info::operator==定义的目标文件，而静态链接的libstdc++.a中也包含该符号的定义，链接器合并符号时发现重复定义，从而触发报错。动态链接时程序会调用系统动态库libstdc++.dll的符号，不会产生冲突；函数体为空时不会实例化acceptor，也就不会引入冲突符号。

解决方案 #

方案1：改用动态链接（最简单可行） #

直接移除静态链接参数，使用默认动态链接方式，编译命令调整为：

g++ -std=c++23 .\main.cpp .\server.cpp -lws2_32 -lboost_system

注：如果Boost是动态编译的，需确保运行时可找到对应的Boost动态库；若为静态Boost，需根据版本调整链接参数。

方案2：匹配版本并正确链接静态Boost库 #

若必须使用静态链接：

1. 确认Boost库是用相同版本的GCC 13.1编译的静态库，避免版本不兼容导致符号差异
2. 编译时明确链接Boost所需静态库，调整链接顺序将Boost库置于-static-libstdc++之前：

g++ -std=c++23 .\main.cpp .\server.cpp -lboost_system -lws2_32 -static-libgcc -static-libstdc++

注：部分新版本Boost.Asio可能无需单独链接boost_system，可根据实际情况调整。

方案3：禁用RTTI（谨慎使用） #

若代码不需要运行时类型识别（RTTI），可添加-fno-rtti编译选项避免生成std::type_info相关符号：

g++ -fno-rtti -static-libgcc -static-libstdc++ -std=c++23 .\main.cpp .\server.cpp -lws2_32

注：该选项会破坏依赖RTTI的代码（如使用dynamic_cast、typeid的逻辑），需谨慎使用。

方案4：更换Mingw环境分支 #

部分Mingw分支（如ucrt64）对静态链接的兼容性更好，可尝试切换至该分支重新编译代码与Boost库。

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