开发工具【免费下载链接】libgit2A cross-platform, linkable library implementation of Git that you can use in your application.项目地址https://gitcode.com/gh_mirrors/li/libgit2点击查看免费下载导读libgit2 是一个跨平台、可链接的 Git 核心库纯 C 实现通常通过 CMake 从源码构建。在配置阶段最常见的失败点与 HTTPS/TLS 支持有关——CMake 会尝试自动探测系统的 SSL/TLS 库一旦找不到就会中断配置。本文以 docs/troubleshooting.md 为核心深入讲解「Asked for OpenSSL TLS backend, but it wasnt found」这类错误的成因、两种标准解法并结合 cmake/SelectHTTPSBackend.cmake 等源码剖析后端自动选择机制帮助你独立排查和解决构建配置问题。一、错误现象与直接原因在从源码构建 libgit2 时执行$ mkdir build cd build $ cmake ..如果环境中缺少 SSL/TLS 开发库CMake 配置会在检查依赖阶段直接报错并中止Asked for OpenSSL TLS backend, but it wasnt found这句错误信息来自 cmake/SelectHTTPSBackend.cmakeelseif(USE_HTTPS STREQUAL openssl) if(NOT OPENSSL_FOUND) message(FATAL_ERROR Asked for OpenSSL TLS backend, but it wasnt found) endif()根本原因libgit2 默认总是开启 HTTPS 支持。CMake 找不到你系统上的 OpenSSL或其头文件、库文件因此无法满足默认配置需求于是报错退出。也就是说这不是代码问题而是构建环境的依赖缺失或探测失败。从源码结构看HTTPS 在 libgit2 中不是一个可选附加功能而是默认构建的一部分顶层 CMakeLists.txt 中USE_HTTPS的默认值即为ON对应的 TLS 流TLS stream实现位于 src/libgit2/streams 目录下openssl.c、mbedtls.c、stransport.c、schannel.c、tls.c等。二、默认 HTTPS 与后端自动选择机制要理解这个错误先要明白 libgit2 是如何决定使用哪个 TLS 后端的。这一逻辑完全集中在 cmake/SelectHTTPSBackend.cmake 中配置阶段先探测候选依赖find_package(OpenSSL)与find_package(mbedTLS)macOS/iOS 上还会探测 Security 与 CoreFoundation 框架USE_HTTPS为空时被强制设为ONcmake/SelectHTTPSBackend.cmake当USE_HTTPSON未显式指定后端时按以下优先级自动挑选cmake/SelectHTTPSBackend.cmake优先级条件选中的后端1macOS/iOS 且 Security 框架支持SSLCreateContextsecuretransport2WindowsWIN32winhttp3找到 OpenSSLopenssl4找到 mbedTLSmbedtls5以上都找不到FATAL_ERROR提示显式指定后端因此「Asked for OpenSSL TLS backend, but it wasnt found」出现的情形通常是非 macOS、非 Windows 的 Unix 类系统上OpenSSL 被优先探测但失败且 mbedTLS 也未安装最终在 OpenSSL 分支直接报错退出。与之对称的还有一条 mbedTLS 分支的错误信息Asked for mbedTLS backend, but it wasnt foundcmake/SelectHTTPSBackend.cmake。运行时层面编译期通过宏如GIT_HTTPS_OPENSSL、GIT_HTTPS_MBEDTLS、GIT_HTTPS_SECURETRANSPORT、GIT_HTTPS_SCHANNEL决定实际链接哪个 TLS 实现src/libgit2/streams/tls.c 中的git_tls_stream_new()会根据这些宏选择对应的流构造函数。三、解决方案一安装系统的 OpenSSL 开发库推荐官方文档给出的首要建议是为你的系统安装 OpenSSL 开发包。以 Debian/Ubuntu 系为例$ sudo apt-get install libssl-dev其他发行版/平台的对应包以官方常见说明为准大致对应关系如下Debian / Ubuntulibssl-devRHEL / CentOS / Fedoraopenssl-develmacOSHomebrewopensslbrew 安装后通常还需配合OPENSSL_ROOT_DIR指定路径见下文第五节Windows默认走winhttp后端一般不依赖 OpenSSL安装完成后重新从干净的 build 目录执行cmake ..即可通过探测。如果系统里其实已经装了 OpenSSL 但 CMake 没找到多半是路径问题见第五节「依赖定位」。四、解决方案二完全禁用 HTTPS 支持如果只是本地开发调试不需要 HTTPS 网络功能可以显式关闭 HTTPS 来跳过所有 TLS 后端的探测$ cmake -DUSE_HTTPSOFF ..在 cmake/SelectHTTPSBackend.cmake 中USE_HTTPSOFF会设置GIT_HTTPS 0同时通过add_feature_info输出 HTTPS support is disabled从而不链接任何 TLS 后端、不触发 FATAL_ERROR。需要说明的是USE_HTTPSOFF会连带禁用https://协议能力http://协议仍可用USE_HTTP独立控制见 CMakeLists.txt。此外 README 中的 可选依赖说明 也指出HTTPS 在 macOS/Windows 上由系统库提供在 Unix 上由 OpenSSL 或 mbedTLS 提供。因此只有在确实不需要 TLS 加密传输时才建议关闭生产环境请优先安装依赖。五、解决方案三显式指定后端与依赖定位5.1 指定其他 TLS 后端与其依赖自动探测不如在配置时明确告诉 CMake 使用哪个后端。顶层 CMakeLists.txt 定义的合法取值包括USE_HTTPS取值说明OpenSSL静态链接 OpenSSL默认 Unix 优先候选OpenSSL-Dynamic不链接 OpenSSL运行时动态加载mbedTLS使用 mbedTLS 作为 TLS 后端SecureTransportmacOS/iOS 系统框架SchannelWindows 系统 SSPI TLSWinHTTPWindows WinHTTP 后端Windows 默认OFF完全禁用 HTTPS例如指定 mbedTLS$ cmake -DUSE_HTTPSmbedTLS ..从源码看mbedTLS 分支还支持通过CERT_LOCATION显式指定默认证书位置否则会尝试调用openssl version -d自动探测常见 CA 证书路径ca-bundle.pem、cert.pem、certs/ca-certificates.crt、certs/ca.pem等见 cmake/SelectHTTPSBackend.cmake。5.2 依赖在非标准路径时的定位如果 OpenSSL 已安装但 CMake 找不到例如 Homebrew 安装的 OpenSSL、交叉编译环境、自定义安装前缀可以通过_ROOT_DIR类选项指定位置。README 的 Locating Dependencies 一节给出了官方示例$ cmake -DOPENSSL_ROOT_DIR/tmp/openssl-3.3.2 ..mbedTLS 的探测逻辑同样支持MBEDTLS_ROOT_DIR提示路径见 cmake/FindmbedTLS.cmake。更细粒度地还可以直接指定库文件位置OPENSSL_SSL_LIBRARY、OPENSSL_CRYPTO_LIBRARY、ZLIB_LIBRARY等见 README.md。5.3 查看当前所有配置项配置完成后可用cmake -L列出所有构建选项及其当前取值快速确认USE_HTTPS等变量的实际状态见 README.md$ cmake -L六、配置成功后的验证与运行依赖问题解决、cmake ..顺利通过后$ cmake --build . $ ctest -V # 从 build 目录运行测试也可直接运行测试程序并指定用例组例如./libgit2_tests -sindex运行索引相关测试详见 README.md。若构建过程中仍遇到编译错误可先确认cmake与 Python测试框架依赖已加入PATH并使用较新的 CMake 版本这些是 README.md 列出的基本构建前提。提示官方文档建议在干净的源码树上构建时不应出现任何测试失败见 README.md。若出现失败可携带构建配置、平台信息与复现步骤向项目维护者反馈。七、小结排查路线图步骤动作对应依据1确认错误信息是否包含Asked for ... backend, but it wasnt foundcmake/SelectHTTPSBackend.cmake2需要 HTTPS安装系统 OpenSSL 开发库如libssl-devdocs/troubleshooting.md3不需要 HTTPS开发调试-DUSE_HTTPSOFFdocs/troubleshooting.md4已装依赖但未找到-DOPENSSL_ROOT_DIR...指定路径README.md5想换后端-DUSE_HTTPSmbedTLS等显式指定CMakeLists.txt6复核配置cmake -L查看所有选项取值README.md本质上Asked for OpenSSL TLS backend, but it wasnt found是「默认开启 HTTPS 依赖探测失败」的必然结果。理解 cmake/SelectHTTPSBackend.cmake 的后端选择优先级就能在三分钟内定位问题并选择最合适的解法装依赖、关 HTTPS或显式切换后端。赞分享开发工具【免费下载链接】libgit2A cross-platform, linkable library implementation of Git that you can use in your application.项目地址https://gitcode.com/gh_mirrors/li/libgit2点击查看免费下载相关推荐Librum编译错误解决常见CMake配置问题排查Librum编译错误解决常见CMake配置问题排查 Librum作为一款现代化的电子书阅读应用其构建系统依赖CMake进行跨平台项目管理。本文将系统梳理编译桌面应用跨平台Caffe2编译错误解决常见CMake配置问题排查Caffe2编译错误解决常见CMake配置问题排查 你是否在编译Caffe2时遇到过CMake配置错误是否因为依赖缺失、路径设置不当而浪费数小时本文将系统上一篇Bitcoin Core 节点入站连接偏少怎么办了解 P2P 出站连接的坏端口bad ports机制下一篇Nextra终极指南如何快速构建结构化知识库的完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考