Windows下如何捆绑OpenSSL v3二进制文件与应用并免批处理运行

方案1：在程序最早期通过全局构造函数设置环境变量 #

问题根源在于你之前在main函数里设置环境变量太晚——OpenSSL的依赖DLL可能在main启动前就被系统加载，此时环境变量还未生效。通过全局对象的构造函数（执行时机早于main）来设置环境变量，确保DLL加载时变量已存在：

#include <cstdlib>
#include <QDir>
#include <QCoreApplication>

// 全局构造函数，在main执行前自动调用
struct OpenSSLEnvSetter {
    OpenSSLEnvSetter() {
        // 获取程序所在绝对目录，避免相对路径出错
        QString appDir = QCoreApplication::applicationDirPath();
        QString modulesPath = QDir(appDir).absoluteFilePath("./lib/ossl-modules");
        QString enginesPath = QDir(appDir).absoluteFilePath("./lib/engines-3");

        // 使用Windows原生函数设置环境变量，或Qt的qputenv均可
        _putenv_s("OPENSSL_MODULES", modulesPath.toStdString().c_str());
        _putenv_s("OPENSSL_ENGINES", enginesPath.toStdString().c_str());
    }
} openSSL_env_setter;

int main(int argc, char ** argv)
{
    QApplication app(argc, argv);
    // 你的业务代码...
    return app.exec();
}

方案2：直接调用OpenSSL API指定路径（推荐） #

绕开环境变量，直接通过OpenSSL的官方API设置模块和引擎的搜索路径，更可靠且不依赖系统环境：

#include <openssl/crypto.h>
#include <openssl/engine.h>
#include <QCoreApplication>
#include <QDir>

int main(int argc, char ** argv)
{
    // 先获取程序绝对路径，确保路径正确
    QString appDir = QCoreApplication::applicationDirPath();
    const char* modulesPath = QDir(appDir).absoluteFilePath("./lib/ossl-modules").toStdString().c_str();
    const char* enginesPath = QDir(appDir).absoluteFilePath("./lib/engines-3").toStdString().c_str();

    // 初始化OpenSSL并设置模块搜索路径
    OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, nullptr);
    OSSL_PROVIDER_set_default_search_path(nullptr, modulesPath);

    // 设置引擎搜索路径
    ENGINE_set_default_search_path(enginesPath);

    // 初始化Qt及后续业务代码
    QApplication app(argc, argv);
    // ...
    return app.exec();
}

额外注意事项 #

• 确保./lib/engines-3和./lib/ossl-modules下的DLL文件完整，且与你的OpenSSL版本（3.x）匹配
• 避免使用相对路径：用户从非程序目录启动exe时，相对路径会失效，务必用基于程序目录的绝对路径
• manifest文件的环境变量配置仅适用于UWP或特定Windows应用模型，普通Win32程序不支持，因此之前的尝试无效

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