CMake构建Qt项目时缺失OpenSSL相关DLL的问题求助

• Qt官方的CMake配置（如FindQt5.cmake/FindQt6.cmake）对zlib、bz2这类常用依赖做了内置处理，会自动添加DLL复制的构建规则，确保这些依赖随项目构建同步复制到输出目录。
• OpenSSL的DLL未被自动复制，通常是因为：
  1. CMake的FindOpenSSL.cmake模块默认仅负责定位库文件（.lib/.so）用于编译链接，不会自动添加DLL的复制规则；
  2. 项目中未明确将OpenSSL的DLL标记为目标的运行时依赖，CMake没有触发自动复制逻辑；
  3. 若为手动安装的OpenSSL，CMake可能未正确识别到DLL的安装路径。

方法1：手动添加构建后复制命令 #

在项目的CMakeLists.txt中添加以下代码，找到OpenSSL的DLL路径并复制到构建目录：

# 先确保已找到OpenSSL
find_package(OpenSSL REQUIRED)

# Windows平台下处理DLL复制
if(WIN32)
  # 定位OpenSSL的DLL文件（通常在OpenSSL安装目录的bin文件夹下）
  find_file(OPENSSL_CRYPTO_DLL libcrypto-3-x64.dll PATHS ${OPENSSL_INCLUDE_DIR}/../bin NO_DEFAULT_PATH)
  find_file(OPENSSL_SSL_DLL libssl-3-x64.dll PATHS ${OPENSSL_INCLUDE_DIR}/../bin NO_DEFAULT_PATH)

  # 找到DLL后，添加构建后复制命令
  if(OPENSSL_CRYPTO_DLL AND OPENSSL_SSL_DLL)
    add_custom_command(TARGET BeastBurst POST_BUILD
      COMMAND ${CMAKE_COMMAND} -E copy_if_different
      ${OPENSSL_CRYPTO_DLL} $<TARGET_FILE_DIR:BeastBurst>
      COMMAND ${CMAKE_COMMAND} -E copy_if_different
      ${OPENSSL_SSL_DLL} $<TARGET_FILE_DIR:BeastBurst>
      COMMENT "Copying OpenSSL DLLs to build directory..."
    )
  endif()
endif()

方法2：通过install规则处理发布打包 #

如果需要在执行install命令时自动复制DLL到发布目录，可以添加：

if(WIN32)
  install(FILES ${OPENSSL_CRYPTO_DLL} ${OPENSSL_SSL_DLL}
    DESTINATION ${CMAKE_INSTALL_BINDIR}
    CONFIGURATIONS Release Debug
  )
endif()

方法3：引用Qt自带的OpenSSL（若Qt已内置） #

如果你的Qt安装包附带了OpenSSL工具（通常在Qt安装目录/Tools/OpenSSL/bin下），可以直接引用该路径：

if(WIN32)
  set(QT_OPENSSL_BIN_DIR "${QT_INSTALL_PREFIX}/../Tools/OpenSSL/bin")
  find_file(OPENSSL_CRYPTO_DLL libcrypto-3-x64.dll PATHS ${QT_OPENSSL_BIN_DIR} NO_DEFAULT_PATH)
  find_file(OPENSSL_SSL_DLL libssl-3-x64.dll PATHS ${QT_OPENSSL_BIN_DIR} NO_DEFAULT_PATH)

  # 复制逻辑同方法1
  if(OPENSSL_CRYPTO_DLL AND OPENSSL_SSL_DLL)
    add_custom_command(TARGET BeastBurst POST_BUILD
      COMMAND ${CMAKE_COMMAND} -E copy_if_different
      ${OPENSSL_CRYPTO_DLL} $<TARGET_FILE_DIR:BeastBurst>
      COMMAND ${CMAKE_COMMAND} -E copy_if_different
      ${OPENSSL_SSL_DLL} $<TARGET_FILE_DIR:BeastBurst>
    )
  endif()
endif()

注意事项 #

• 确保find_package(OpenSSL REQUIRED)已正确执行，CMake能定位到OpenSSL的头文件和库文件；
• 若使用vcpkg等包管理器安装OpenSSL，通常包管理器会自动处理DLL复制，需检查是否正确配置了vcpkg的CMake工具链；
• 调试版和发布版的OpenSSL DLL可能不同，可通过$<CONFIG>变量区分构建配置。

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