如何通过Makefile将OpenCV .dll链接到自建.dll项目并解决运行崩溃问题

我需要将预编译的OpenCV动态库（多个.dll文件）整合到自己的.dll项目中。目前项目编译成功，但运行时总是崩溃；将这些OpenCV .dll放置到程序根目录后，运行则正常。

原始Makefile #

TARGET = MyNewLib.dll
CXX = g++.exe

LIB_PATH = PATH/TO/OPENCV/LIB_FOLDER

CXXFLAGS = -std=c++11 -I/$(LIB_PATH)/opencv/include

OPENCV_DIR = $(LIB_PATH)/opencv/x86/mingw/lib
OPENCV_LIBS = -lopencv_core2413 -lopencv_imgproc2413 -lopencv_highgui2413

SOURCES = $(wildcard *.cpp) 
INCLUDES = $(wildcard *.h) $(wildcard /$(LIB_PATH)/opencv/include/opencv2/*.hpp)
OBJECTFILES = $(SOURCES:%.cpp=%.o)


build: $(TARGET)

$(TARGET): $(OBJECTFILES)
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) $(OPENCV_LIBS) -I/$(LIB_PATH)/opencv/include

.cpp.o:
    $(CXX) -MD -MP $(CXXFLAGS) -o $@ -c $<

clean:
    - testprogram.exe -c "unload code" 2> NUL
    $(RM) $(OBJECTFILES) $(TARGET)
    
$(OBJECTFILES): $(INCLUDES)

OpenCV目录结构 #

PATH/TO/OPENCV/.
- include
  - opencv
  - opencv2（包含各类文件夹及opencv.hpp等.hpp文件）
- x86/mingw/
  - bin（存放libopencv_core2413.dll等.dll文件）
  - lib（存放libopencv_core2413.dll.a等文件）

已尝试的解决方案 #

我尝试过设置LD_RUN_PATH，修改Makefile如下：

TARGET = MyNewLib.dll
CXX = g++.exe

LIB_PATH = PATH/TO/OPENCV/LIB_FOLDER

CXXFLAGS = -std=c++11 -I/$(LIB_PATH)/opencv/include

OPENCV_DIR = $(LIB_PATH)/opencv/x86/mingw/lib
OPENCV_LIBS = -lopencv_core2413 -lopencv_imgproc2413 -lopencv_highgui2413

SOURCES = $(wildcard *.cpp) 
INCLUDES = $(wildcard *.h) $(wildcard /$(LIB_PATH)/opencv/include/opencv2/*.hpp)
OBJECTFILES = $(SOURCES:%.cpp=%.o)


build: $(TARGET)

$(TARGET): $(OBJECTFILES)
    export LD_RUN_PATH=$(OPENCV_DIR)/:/path/to/lib2:/path/to/lib3
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) $(OPENCV_LIBS) -I/$(LIB_PATH)/opencv/include
    export LD_RUN_PATH=/$(LIB_PATH)/opencv/x86/mingw/bin/libopencv_core2413.dll:/$(LIB_PATH)/opencv/x86/mingw/bin/libopencv_imgproc2413.dll:/$(LIB_PATH)/opencv/x86/mingw/bin/libopencv_highgui2413.dll
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) -L/$(LIB_PATH)/opencv/x86/mingw/lib/libopencv_core2413.dll.a -lopencv_core2413 -L/$(LIB_PATH)/opencv/x86/mingw/lib/libopencv_imgproc2413.dll.a -lopencv_imgproc2413  -L/$(LIB_PATH)/opencv/x86/mingw/lib/libopencv_highgui2413.dll.a -lopencv_highgui2413
    
.cpp.o:
    $(CXX) -MD -MP $(CXXFLAGS) -o $@ -c $<

clean:
    - testprogram.exe -c "unload code" 2> NUL
    $(RM) $(OBJECTFILES) $(TARGET)
    
$(OBJECTFILES): $(INCLUDES)

也尝试过添加-Wl,-rpath参数：

TARGET = MyNewLib.dll
CXX = g++.exe

LIB_PATH = PATH/TO/OPENCV/LIB_FOLDER

CXXFLAGS = -std=c++11 -I/$(LIB_PATH)/opencv/include

OPENCV_DIR = $(LIB_PATH)/opencv/x86/mingw/lib
OPENCV_LIBS = -lopencv_core2413 -lopencv_imgproc2413 -lopencv_highgui2413 -Wl,-rpath=../$(OPENCV_DIR)

SOURCES = $(wildcard *.cpp) 
INCLUDES = $(wildcard *.h) $(wildcard /$(LIB_PATH)/opencv/include/opencv2/*.hpp)
OBJECTFILES = $(SOURCES:%.cpp=%.o)


build: $(TARGET)

$(TARGET): $(OBJECTFILES)
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) $(OPENCV_LIBS)

.cpp.o:
    $(CXX) -MD -MP $(CXXFLAGS) -o $@ -c $<

clean:
    - testprogram.exe -c "unload code" 2> NUL
    $(RM) $(OBJECTFILES) $(TARGET)
    
$(OBJECTFILES): $(INCLUDES)

但仍无法解决运行时从非根目录加载OpenCV动态库的问题，恳请帮忙。

核心问题分析 #

你使用的是Windows环境（g++.exe、.dll），但尝试了Linux专属的LD_RUN_PATH和-rpath参数——这些在Windows系统中完全不生效。Windows加载DLL的搜索顺序和Linux不同，默认只会查找程序根目录、系统目录，或者环境变量PATH中配置的路径。

可行方案 #

方案1：修改系统环境变量PATH

将OpenCV的DLL目录（PATH/TO/OPENCV/x86/mingw/bin）添加到系统PATH环境变量中。注意修改后需要重启终端或IDE才能生效。

方案2：在Makefile中自动复制DLL到输出目录

在编译完成后，自动将所需的OpenCV DLL复制到MyNewLib.dll所在目录，确保运行时能直接找到：
修改Makefile的$(TARGET)规则，添加复制命令：

$(TARGET): $(OBJECTFILES)
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) $(OPENCV_LIBS) -I/$(LIB_PATH)/opencv/include
    # 复制OpenCV DLL到当前目录（MinGW环境用cp，原生Windows用copy）
    cp $(LIB_PATH)/opencv/x86/mingw/bin/libopencv_core2413.dll .
    cp $(LIB_PATH)/opencv/x86/mingw/bin/libopencv_imgproc2413.dll .
    cp $(LIB_PATH)/opencv/x86/mingw/bin/libopencv_highgui2413.dll .

方案3：链接时硬编码DLL路径（不推荐）

MinGW支持在链接时指定DLL的搜索路径，但会把绝对路径硬编码到你的DLL中，移植性极差：
修改链接参数，添加-Wl,--enable-auto-import和-Wl,--dll-search-paths=$(LIB_PATH)/opencv/x86/mingw/bin：

$(TARGET): $(OBJECTFILES)
    ${LINK.cc} -shared -o $@ ${OBJECTFILES} -L/$(OPENCV_DIR) $(OPENCV_LIBS) -I/$(LIB_PATH)/opencv/include -Wl,--enable-auto-import -Wl,--dll-search-paths=$(LIB_PATH)/opencv/x86/mingw/bin

一旦OpenCV目录移动，该方案会直接失效，不推荐使用。

方案4：代码中动态加载DLL

在代码中手动调用Windows API加载OpenCV DLL，指定完整路径：

#include <windows.h>

// 初始化阶段加载DLL
HINSTANCE hCoreDll = LoadLibrary(TEXT("PATH/TO/OPENCV/x86/mingw/bin/libopencv_core2413.dll"));
HINSTANCE hImgProcDll = LoadLibrary(TEXT("PATH/TO/OPENCV/x86/mingw/bin/libopencv_imgproc2413.dll"));
HINSTANCE hHighGuiDll = LoadLibrary(TEXT("PATH/TO/OPENCV/x86/mingw/bin/libopencv_highgui2413.dll"));

// 使用完成后卸载
FreeLibrary(hCoreDll);
FreeLibrary(hImgProcDll);
FreeLibrary(hHighGuiDll);

该方式需要手动处理函数指针，复杂度高，仅适合特殊场景。

推荐方案 #

优先选择方案2，自动化复制DLL到输出目录，既保证运行正常，又不依赖系统环境变量，移植性最佳。

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