在C++项目中延迟加载FFmpeg C库遇启动加载问题求助

阿华AIGC实验室

2026-5-27

解决FFmpeg DLL延迟加载的问题

你遇到的这个问题，本质是链接器的默认导入行为在搞鬼：当你直接调用DLL里的函数时，链接器会自动把这些函数的导入项标记为「立即加载」——哪怕你代码里的调用逻辑还没执行，程序启动时就会扫描导入表，强制加载对应的DLL。哪怕你自己手动用LoadLibrary拿到了DLL句柄，链接器生成的导入表优先级更高，所以启动时还是会报错找不到DLL。

下面给你两种靠谱的解决方案，按需选择：

方案一：用编译器的延迟加载选项（简单高效）

主流编译器（MSVC、GCC）都支持延迟加载DLL的特性，能让链接器把导入表改成「延迟加载」，直到第一次调用函数时才触发DLL加载。

针对MSVC的操作步骤：

打开项目属性，找到「链接器」→「输入」，在「延迟加载的DLL」里填上你要延迟加载的FFmpeg DLL（比如avcodec-xx.dll、avformat-xx.dll这类）。
确保你已经链接了FFmpeg的导入库.lib（注意是导入库，不是静态库哦）。
额外添加delayimp.lib到「附加依赖项」里——这是MSVC提供的延迟加载支持库，没有它的话延迟加载会失效。

设置完之后，程序启动时不会碰这些DLL，直到你第一次调用FFmpeg函数时，系统才会自动加载。如果加载失败，你还可以通过__pfnDliNotifyHook2钩子自定义错误处理（比如提示用户指定DLL路径，或者自动从指定目录加载）。

方案二：完全手动绑定函数（极致灵活）

如果需要更精细的控制（比如自己指定DLL路径、在特定时机加载），可以彻底绕过导入表，手动用Windows API加载DLL并获取函数指针。

具体操作：

不要直接包含FFmpeg头文件后调用函数，而是自己声明对应的函数指针类型（注意FFmpeg是C导出的，必须加extern "C"避免名字修饰）：

extern "C" {
// 对应avformat_open_input的函数指针类型
typedef int(*avformat_open_input_ptr)(AVFormatContext**, const char*, AVInputFormat*, AVDictionary**);
// 对应avformat_close_input的函数指针类型
typedef void(*avformat_close_input_ptr)(AVFormatContext**);
// 其他需要用到的FFmpeg函数，都按这个方式声明指针类型
}

手动加载DLL并获取函数指针：

// 这里可以替换成你实际的DLL路径，比如从配置文件读取
HMODULE hAvFormat = LoadLibrary(L"your/path/to/avformat-xx.dll");
if (!hAvFormat) {
    // 处理加载失败的逻辑，比如弹窗提示用户
    return -1;
}

// 通过函数名获取指针
avformat_open_input_ptr avformat_open_input = 
    reinterpret_cast<avformat_open_input_ptr>(GetProcAddress(hAvFormat, "avformat_open_input"));
avformat_close_input_ptr avformat_close_input = 
    reinterpret_cast<avformat_close_input_ptr>(GetProcAddress(hAvFormat, "avformat_close_input"));

// 一定要检查指针不为空再调用
if (avformat_open_input) {
    avformat_open_input(&fmt_ctx, input_url, nullptr, nullptr);
}