链接静态库时DLL导出大量外部库函数的问题

问题描述 #

使用MinGW GCC编译SHARED库（DLL）时，最终生成的DLL会导出所有依赖库（如OpenSSL Crypto、Protobuf、Curl等）的符号，编译EXE时无此问题。

原因分析 #

MinGW链接静态库到DLL时，默认会将静态库中的所有符号纳入DLL的导出表。即便全局设置了-fvisibility=hidden，如果依赖的静态库（包括自定义静态库和vcpkg提供的库）未启用符号隐藏，或者链接器未被明确告知排除这些符号，它们就会被意外导出。

解决方案 #

1. 显式控制DLL导出符号 #

仅导出需要对外暴露的函数/类，避免默认导出所有符号：

• 在头文件（如credentials.h）中定义导出宏：

  #ifdef CORE_EXPORTS
  #define CORE_API __declspec(dllexport)
  #else
  #define CORE_API __declspec(dllimport)
  #endif
  
  // 仅标记需要导出的函数
  CORE_API void MyPublicFunction();
  

• 在Core库的CMake配置中添加编译定义，启用导出：

  target_compile_definitions(Core PRIVATE CORE_EXPORTS)
  

2. 链接器排除静态库符号导出 #

给Core库添加链接器选项，阻止从静态库引入的符号被导出：

target_link_options(Core PRIVATE "-Wl,--exclude-libs,ALL")

该选项会告诉lld链接器，不要将任何静态库中的符号加入DLL的导出表，仅保留DLL自身显式导出的符号。若需保留特定静态库的符号，可替换ALL为具体库名（如libprotobuf.a）。

3. 给自定义静态库启用符号隐藏 #

对自己编写的静态库（utils、crypto、proto等）强制启用符号隐藏，避免内部符号被意外导出：

# 在主CMakeLists.txt中全局设置，或给每个静态库单独配置
set_target_properties(utils crypto proto web windows_utils PROPERTIES
  CXX_VISIBILITY_PRESET hidden
  VISIBILITY_INLINES_HIDDEN ON
)

修改后的CMake示例 #

主CMakeLists.txt #

cmake_minimum_required(VERSION 3.24)
project(RewrittenModule)

set(CMAKE_VERBOSE_MAKEFILE on)
set(CMAKE_CXX_STANDARD 17)

# 全局启用符号隐藏（对自定义库生效）
set(CMAKE_CXX_VISIBILITY_PRESET hidden)
set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)

# 编译选项（避免全局设置CXX_FLAGS影响依赖库）
add_compile_options(
  -fno-ident -s -O3 -fno-use-linker-plugin
  -fdata-sections -ffunction-sections
  -fstack-protector -fuse-ld=lld
  -fno-math-errno -march=native
)

# 链接选项
add_link_options(
  -Wl,--gc-sections -Wl,--strip-all
)

find_package(fmt CONFIG REQUIRED)
find_package(Protobuf CONFIG REQUIRED)

add_subdirectory(utils)
add_subdirectory(crypto)
add_subdirectory(proto)
add_subdirectory(web)
add_subdirectory(windows_utils)

add_subdirectory(cmake_configs/windows_x64)

cmake_configs/windows_x64/CMakeLists.txt #

add_library(Core SHARED ../../main.cpp ../../credentials.h)

set_target_properties(Core PROPERTIES
  PREFIX ""
  OUTPUT_NAME "native"
)

# 启用自定义符号导出
target_compile_definitions(Core PRIVATE CORE_EXPORTS)

# 排除静态库符号导出
target_link_options(Core PRIVATE "-Wl,--exclude-libs,ALL")

target_link_libraries(Core PRIVATE
  utils
  fmt::fmt
  crypto
  proto
  web
  windows_utils
)

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