C++虚重载接口调用异常：传bool参数却触发float重载函数

这摆明是跨动态库（模块）C++虚函数ABI不兼容的锅——UE项目的编译环境和Arduino代码注入后生成的动态库环境，在虚函数表（VTable）布局、名称修饰规则或者调用约定上没对齐，导致调用虚函数时找错了VTable里的条目，连参数传递都乱了套。

1. 死磕ABI一致性，一丝一毫都不能差 #

• 必须保证UE项目和Arduino动态库用完全一样的编译器版本（比如都是VS2022 17.8版本）、相同的C++标准（比如统一用C++17）、一致的调用约定（默认是__cdecl，但UE可能有自定义设置，两边必须对齐）。
• 给接口类加上导出/导入标记，用宏统一控制，两边项目都用这个宏：

  #ifdef ARDUINO_LIB_EXPORTS
  #define ARDUINO_API __declspec(dllexport)
  #else
  #define ARDUINO_API __declspec(dllimport)
  #endif
  
  class ARDUINO_API IArduino {
  public:
      virtual ~IArduino() = default;
      // 注意：虚函数的声明顺序绝对不能改，两边必须完全一致
      virtual void pinMode(float) = 0;
      virtual void pinMode(bool) = 0;
      // 其他接口函数
  };
  

  重点强调：虚函数的声明顺序是核心，哪怕换个顺序，VTable的索引就错位了，调用必然乱套。

2. 别用容易搞混的参数类型重载 #

bool和float这俩参数在某些编译器的调用约定里，内存占用和传递方式容易有歧义（比如bool是1字节，float是4字节，不同编译器对重载函数的VTable排序逻辑可能不一样）。直接换个方式区分重载：

• 最简单的：给函数改名字，彻底避免重载：

  class IArduino {
  public:
      virtual ~IArduino() = default;
      virtual void pinModeFloat(float pinVal) = 0;
      virtual void pinModeBool(bool pinVal) = 0;
  };
  

• 或者用标签类做区分，既保留函数名又能明确参数类型：

  // 定义两个空标签类
  struct FloatPin {};
  struct BoolPin {};
  
  class IArduino {
  public:
      virtual ~IArduino() = default;
      virtual void pinMode(FloatPin, float pinVal) = 0;
      virtual void pinMode(BoolPin, bool pinVal) = 0;
  };
  // 调用的时候这么写：
  arduinoPtr->pinMode(FloatPin{}, 2.5f);
  arduinoPtr->pinMode(BoolPin{}, true);
  

3. 检查注入代码的逻辑，别偷偷改接口 #

确保Arduino代码注入的时候，生成的动态库严格按照IArduino的定义来，没在注入过程中偷偷改虚函数的声明顺序或者参数类型——比如有些注入工具可能会自动调整函数签名，这绝对要禁止。

4. 关掉可能搞乱VTable的编译器优化 #

某些编译器优化（比如VS的/O2或者/Ob2）可能会调整虚函数表的布局，或者对重载函数做特殊优化。两边项目要么都开相同的优化级别，要么直接禁用那些影响VTable的优化选项。

• 用VS的dumpbin /exports工具查看Arduino动态库的导出符号，对比UE项目里IArduino类的函数名称修饰，确保两个pinMode的修饰名完全一致。
• 在UE的ArduinoImpl类里给两个pinMode加日志输出，比如打印函数名和参数值，确认调用时进的是哪个函数，参数对不对。

内容的提问来源于stack exchange，提问作者Saulo Soares Oliveira