项目可在Ubuntu编译正常，Debian下却出现链接错误求助

项目在Ubuntu 22.04和Windows环境编译正常，但在Debian Bullseye中，即便使用同版本的GCC和CMake，仍出现如下链接错误：

#16 953.5 `_ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateEPZNS8_8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_E305_ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_.Frame.destroy' referenced in section `.rodata.cst8' of src/gw2cc/Release/libgw2cc_lib.a(SecureTokenServerClient.cpp.o): defined in discarded section `.text._ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateEPZNS8_8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_E305_ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_.Frame.destroy[_ZN7network6socks56socketIN5boost4asio19basic_stream_socketINS3_2ip3tcpENS3_15any_io_executorEEEE10do_connectERKNS5_14basic_endpointIS6_EERKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEESL_]' of src/gw2cc/Release/libgw2cc_lib.a(SecureTokenServerClient.cpp.o)

项目通过vcpkg管理所有依赖，Linux编译均在干净Docker镜像中完成，更换GCC版本也无法解决问题。

可能的原因与解决方案 #

1. 链接器垃圾回收（GC）机制差异 #

Debian Bullseye默认可能启用了--gc-sections链接选项，而Ubuntu 22.04的默认配置不同，导致Boost.Asio协程相关的符号所在代码段被误判为无用而丢弃，但代码中仍有引用。

• 解决方案：
  在CMakeLists.txt中为目标显式禁用链接器垃圾回收：

  target_link_options(your_target PRIVATE "-Wl,--no-gc-sections")
  

  如果必须保留垃圾回收，可以通过-u选项强制保留出错的符号：

  target_link_options(your_target PRIVATE "-Wl,-u,_ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateEPZNS8_8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_E305_ZN5boost4asio12async_resultINS0_15use_awaitable_tINS0_15any_io_executorEEEJFvNS_6system10error_codeEmEEE8initiateINS0_6detail36initiate_async_write_buffer_sequenceINS0_19basic_stream_socketINS0_2ip3tcpES3_EEEEJSt5arrayINS0_12const_bufferELm4EENSA_14transfer_all_tEEEENS0_9awaitableImS3_EET_S4_DpT0_.Frame.destroy")
  

2. Boost.Asio协程编译宏不一致 #

Debian和Ubuntu的vcpkg构建Boost时，默认的协程相关宏定义可能不同，导致生成的符号不匹配。

• 解决方案：
  在CMakeLists.txt中显式设置协程相关编译定义，确保与Ubuntu环境一致：

  target_compile_definitions(your_target PRIVATE BOOST_ASIO_HAS_CO_AWAIT BOOST_ASIO_USE_STD_COROUTINES)
  

  同时在vcpkg.json中指定Boost.Asio的coroutines特性：

  "dependencies": [
    {
      "name": "boost-asio",
      "features": ["coroutines"]
    }
  ]
  

3. 符号可见性设置差异 #

Debian默认可能使用-fvisibility=hidden编译选项，导致Boost.Asio内部符号被隐藏，链接时无法解析。

• 解决方案：
  在CMakeLists.txt中为目标设置符号可见性为默认：

  target_compile_options(your_target PRIVATE "-fvisibility=default")
  

  或者在构建vcpkg依赖时，设置环境变量强制Boost使用默认可见性：

  export VCPKG_CXX_FLAGS="-fvisibility=default"
  vcpkg install
  

4. 链接器版本差异 #

Debian Bullseye使用的ld版本（通常为2.35）低于Ubuntu 22.04的2.38，旧版本链接器对C++20协程符号的处理存在兼容性问题。

• 解决方案：
  尝试升级Debian的binutils到更高版本，或者指定使用gold链接器：

  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fuse-ld=gold")
  set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -fuse-ld=gold")
  

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