使用CMake无法静态链接libcrypto库的问题求助

问题描述 #

我正在构建一个依赖OpenSSL libcrypto库的应用程序，之前一直采用动态链接方式，现在希望切换为静态链接。查阅资料得知需将OPENSSL_USE_STATIC_LIBS标志设置为TRUE并重置构建缓存，理论上CMake应找到并链接OpenSSL的静态版本（若存在）。但实际情况是CMake确实找到了libcrypto.lib，可最终可执行文件仍链接到DLL。

CMake日志 #

-- The C compiler identification is MSVC 19.38.33133.0
-- The CXX compiler identification is MSVC 19.38.33133.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/bin/Hostx64/x64/cl.exe - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/bin/Hostx64/x64/cl.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Failed
-- Looking for pthread_create in pthreads
-- Looking for pthread_create in pthreads - not found
-- Looking for pthread_create in pthread
-- Looking for pthread_create in pthread - not found
-- Found Threads: TRUE 
-- Found OpenSSL: C:/Program Files/OpenSSL/lib/libcrypto.lib (found version "3.0.10")  # <== 正确找到libcrypto.lib
-- Configuring done (5.3s)
-- Generating done (0.0s)

CMakeLists.txt内容 #

cmake_minimum_required(VERSION 3.23)
project(common)

set(CMAKE_CXX_STANDARD 20)

set(OPENSSL_USE_STATIC_LIBS TRUE)    # <== 在find_package前已正确设置
find_package(OpenSSL REQUIRED)

add_library(common STATIC
        common.cpp)
target_include_directories(common PUBLIC include)
target_link_libraries(common OpenSSL::Crypto)

环境信息 #

• cmake：3.28.1（JetBrains IDE捆绑版，版本16）
• cl.exe：Microsoft (R) C/C++优化编译器 版本19.38.33133 for x86
• LINK.exe：Microsoft (R)增量链接器 版本14.38.33133.0
• ninja：1.12.0
• OpenSSL：3.0.10 1 Aug 2023（库版本：OpenSSL 3.0.10 1 Aug 2023）

我未发现操作有误，参考相关帖子后，我的CMakeLists写法与示例一致。

解决方案 #

针对MSVC环境下的这个问题，可尝试以下排查和修复步骤：

1. 确认OpenSSL静态库的真实存在
   Windows上部分OpenSSL预编译包中，libcrypto.lib可能是动态链接的导入库，而非真正的静态库。检查你的OpenSSL安装目录，静态库通常会放在lib/VC/static这类子目录下，文件名同样是libcrypto.lib，但文件大小会远大于导入库。

2. 强制指定静态库路径
   如果CMake默认识别的是动态导入库，可手动指定静态库的路径：

set(OPENSSL_ROOT_DIR "C:/Program Files/OpenSSL")
# 替换为你实际的静态库路径
set(OPENSSL_LIBRARIES "${OPENSSL_ROOT_DIR}/lib/VC/static/libcrypto.lib")
set(OPENSSL_INCLUDE_DIR "${OPENSSL_ROOT_DIR}/include")
find_package(OpenSSL REQUIRED)

3. 配置MSVC静态CRT
   MSVC环境下，若使用动态CRT，即使链接了静态libcrypto，也可能因CRT的动态依赖间接链接DLL。添加以下代码强制使用静态CRT：

if(MSVC)
    # Release模式用MT，Debug模式用MTd
    set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /MT")
    set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /MTd")
endif()

4. 彻底清除缓存后重建
   完全删除CMake构建目录（如build文件夹），再重新运行CMake配置和构建，避免旧缓存残留的链接规则影响结果。

5. 检查OpenSSL目标属性
   在CMakeLists中添加以下代码，查看OpenSSL::Crypto目标的实际类型：

get_target_property(CRYPTO_TARGET_TYPE OpenSSL::Crypto TYPE)
message(STATUS "OpenSSL::Crypto target type: ${CRYPTO_TARGET_TYPE}")

如果输出是SHARED_LIBRARY，说明CMake仍将其识别为动态库，需要调整查找逻辑或更换OpenSSL安装包。

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