使用MinGW生成的库文件时出现未定义引用问题求助

问题背景 #

在Win10环境下，使用MinGW32（i686-w64-mingw32 4.4.1）、g++ 13.2.0编译PDF-Writer-4.6.4生成静态库后，链接应用程序时出现大量未定义引用错误，涉及AES加密（aes_init、aes_encrypt_key等）和PNG处理（png_set_longjmp_fn、png_get_image_width等）函数。已在链接选项中添加所有依赖库，但问题依旧，使用libharu时也遇到类似情况。

排查步骤 #

1. 调整链接库顺序 #

GCC链接器按从左到右的顺序解析依赖关系，被依赖的库必须放在依赖它的库之前。当前链接顺序将-lPDFWriter放在最后，而PDFWriter实际依赖前面的所有库，需调整顺序为：

-lPDFWriter -lLibAesgm -lZlib -lLibTiff -lLibPng -lFreeType

2. 验证依赖库的编译兼容性 #

• 确保所有依赖库（LibAesgm、Zlib、LibTiff等）均使用**同一版本的MinGW32（i686-w64-mingw32）**编译，禁止混用MSVC或其他架构的库。
• 用objdump -f libXXX.a查看库文件的架构信息，确认输出中的architecture字段为i386:x86-64，与PDFWriter库的架构完全匹配。

3. 检查依赖库是否包含缺失符号 #

用以下命令验证依赖库是否存在目标符号：

• 检查AES库：nm -D libLibAesgm.a | grep aes_init
• 检查PNG库：nm -D libLibPng.a | grep png_set_longjmp_fn
  若符号不存在，说明依赖库编译不完整，需重新编译并确保启用对应功能（比如PNG库需开启longjmp相关编译选项）。

4. 核对PDFWriter的CMake编译配置 #

• 查看CMake生成Makefile时的输出日志，确认所有依赖库的路径和头文件均被正确检测，无依赖未找到的警告。
• 编译PDFWriter时添加-DCMAKE_VERBOSE_MAKEFILE=ON参数，检查编译命令是否正确包含依赖库的头文件路径，链接阶段是否正确关联了依赖库。

5. 统一编译器选项 #

• 确保编译PDFWriter、依赖库和应用程序时，使用相同的C++标准（-std=c++17），避免因标准差异导致符号不兼容。
• 检查编译宏的一致性，比如PDFWriter编译时是否定义了NDEBUG、WIN32等宏，应用程序需保持相同的宏定义。

6. 尝试切换为动态库链接 #

若静态库链接问题难以解决，可将PDFWriter及依赖库编译为动态库（.dll），链接时使用对应的导入库（.dll.a）。动态库的链接规则相对宽松，可能规避静态库的顺序和符号匹配问题。

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