MinGW ld链接错误：undefined reference问题排查求助

问题分析 #

链接器报错找不到SBC_RequestTriggerSwitches的定义，但通过dumpbin查看库导出符号时，发现实际导出的是C++类成员函数Thorlabs::MotionControl::Benchtop::StepperMotor::CBenchtopStepperMotorChannel::RequestTriggerSwitches。结合头文件和SWIG接口内容，问题根源在于符号声明与实际导出不匹配、宏定义使用错误，以及可能的编译器/链接器兼容性问题。

错误详情 #

2024-03-14 18:26:40,630 - ERROR - 
        ------------------------------
        Error compiling stepper_motor:
        
        Error code: 1
        Error: C:/SysGCC/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/12.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\User\AppData\Local\Temp\ccfElxip.o:stepper_motor_wrap.cxx:(.text+0x178a4): undefined reference to `SBC_RequestTriggerSwitches'collect2.exe: error: ld returned 1 exit status

        g++ command: ['g++', '-shared', '-o', 'd:\\CZI_scope\\code\\pymodules\\thorlabs_kinesis\\motion_control\\benchtop\\_stepper_motor.pyd', 'd:\\CZI_scope\\code\\pymodules\\thorlabs_kinesis\\motion_control\\benchtop\\stepper_motor_wrap.cxx', '-Ic:\\Users\\User\\mambaforge\\envs\\rich\\include', '-Id:\\CZI_scope\\code\\pymodules\\thorlabs_kinesis\\__include', '-Lc:\\Users\\User\\mambaforge\\envs\\rich', '-Ld:\\CZI_scope\\code\\pymodules\\thorlabs_kinesis\\__lib', '-lpython39', '-lThorlabs.MotionControl.Benchtop.StepperMotor', '-Wno-error']        
        ------------------------------

关键信息 #

库导出符号（dumpbin输出） #

?RequestTriggerSwitches@CBenchtopStepperMotorChannel@StepperMotor@Benchtop@MotionControl@Thorlabs@@QEBAFXZ (public: short __cdecl Thorlabs::MotionControl::Benchtop::StepperMotor::CBenchtopStepperMotorChannel::RequestTriggerSwitches(void)const )

头文件定义 #

#ifdef BENCHTOPSTEPPERMOTORDLL_EXPORTS
/// <summary> Gets the Benchtop Stepper API. </summary>
#define BENCHTOPSTEPPERMOTOR_API __declspec(dllexport)
#else
#define BENCHTOPSTEPPERMOTOR_API __declspec(dllimport)
#endif
extern "C"
{
BENCHTOPSTEPPERMOTOR_API short __cdecl SBC_RequestTriggerSwitches(char const * serialNo, short channel);
...
}

原始SWIG接口文件 #

%module stepper_motor

// Remove calling convention macros compatibility with SWIG
#define __cdecl
#define __stdcall
#define __declspec(x) 
#define WINAPI

%{
#include <windows.h>
#include <stdbool.h>
#define BENCHTOPSTEPPERMOTORDLL_EXPORTS 
#include "Thorlabs.MotionControl.Benchtop.StepperMotor.h"
%}
%include "Thorlabs.MotionControl.Benchtop.StepperMotor.h"

解决方案 #

1. 修正SWIG接口的宏定义 #

移除SWIG接口中的#define BENCHTOPSTEPPERMOTORDLL_EXPORTS——该宏用于编译库时标记导出符号，当前场景是导入库，错误定义会导致头文件将API声明为dllexport而非dllimport，引发符号匹配问题。修改后的接口：

%module stepper_motor

// Remove calling convention macros compatibility with SWIG
#define __cdecl
#define __stdcall
#define __declspec(x) 
#define WINAPI

%{
#include <windows.h>
#include <stdbool.h>
#include "Thorlabs.MotionControl.Benchtop.StepperMotor.h"
%}
%include "Thorlabs.MotionControl.Benchtop.StepperMotor.h"

2. 对齐头文件与库的导出方式 #

从dumpbin输出可知，库实际导出的是C++类成员函数，而非头文件中声明的C风格包装函数。需确认：

• 若头文件与库版本不匹配，更换为与当前库对应的头文件；
• 若库仅提供C类接口，调整SWIG接口以处理C类，确保头文件包含CBenchtopStepperMotorChannel类的完整定义，让SWIG生成对应的Python类接口。

3. 解决编译器/链接器兼容性问题 #

当前使用MinGW的g++链接MSVC编译的.lib文件，两者名字修饰规则不同，可能导致符号无法解析。可通过以下两种方式解决：

• 改用MSVC编译：使用Visual Studio的cl.exe编译SWIG生成的包装代码，匹配库的编译环境；
• 生成MinGW兼容的导入库：
  1. 用gendef从DLL导出符号：

     gendef Thorlabs.MotionControl.Benchtop.StepperMotor.dll
     

  2. 用dlltool生成MinGW可用的.a库：

     dlltool -D Thorlabs.MotionControl.Benchtop.StepperMotor.dll -d Thorlabs.MotionControl.Benchtop.StepperMotor.def -l libThorlabs.MotionControl.Benchtop.StepperMotor.a
     

  3. 链接时指向生成的.a文件，确保-L路径包含该文件所在目录。

4. 验证库路径与位数匹配 #

确认-Ld:\\CZI_scope\\code\\pymodules\\thorlabs_kinesis\\__lib路径下存在正确的库文件，且库的位数（32/64位）与Python环境（python39）一致。

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