UE5派生类传入基类形参函数报指针转换失败编译错误

问题场景 #

触发编译报错：
cannot convert argument 1 from 'UMyDerivedClass *' to 'UMyBaseClass *'
复现条件：

• 自定义UMyBaseClass、UMyDerivedClass两个UObject派生类
• 形参类型为UMyBaseClass*的函数（重写自自定义接口），传入UMyDerivedClass*类型实参时触发报错
• 相同写法传入引擎自带类的派生实例无同类问题

排查步骤 #

按优先级从高到低逐一验证：

• 头文件包含完整性检查
  确认调用函数的源文件中，明确引入了UMyDerivedClass.h头文件，而非仅做类的前置声明。如果编译器看不到UMyDerivedClass的完整类定义、无法获知其与UMyBaseClass的继承关系，就会判定两个指针类型无关联，拒绝隐式向上转型。引擎自带类未触发该问题，通常是因为引擎头文件被其他依赖项间接包含，继承关系对编译器可见。
• 类定义合法性检查
  确认两个类的定义符合UE规范：
  1. 两个类都必须添加UCLASS()宏，类内必须包含GENERATED_BODY()宏，避免UHT（Unreal头文件工具）无法正确生成类型反射信息
  2. 派生类的继承修饰符必须为public，C++中class默认继承权限为private，私有继承场景下外部无法完成派生类到基类的指针转换
     正确的类定义示例：

  // UMyBaseClass.h
  UCLASS()
  class MYPROJECT_API UMyBaseClass : public UObject
  {
      GENERATED_BODY()
  };
  
  // UMyDerivedClass.h
  UCLASS()
  class MYPROJECT_API UMyDerivedClass : public UMyBaseClass
  {
      GENERATED_BODY()
  };
  

• 接口重写签名一致性检查
  逐一核对三处函数声明的类型完全匹配：接口类中的原函数声明、实现类中重写的函数声明、实际调用的函数。重点排查是否存在同名类的命名空间冲突、前向声明导致的类型指代错误。重写函数时建议添加override关键字，编译器可提前拦截签名不匹配的问题。
• 缓存与类型验证
  若以上检查均无问题，先在传参时使用Cast<UMyBaseClass>(DerivedInstancePtr)做显式转换：
  1. 如果显式转换编译通过、运行时返回值非空，说明继承关系本身成立，问题根源还是编译阶段的类型可见性，回头排查头文件包含和命名冲突即可
  2. 如果显式转换也报错，删除项目目录下的Intermediate、Saved文件夹，重新生成IDE项目文件后全量编译，排除UHT缓存过期导致的类型信息识别错误。

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