UE5中ATTRIBUTE_ACCESSORS宏报错及引擎崩溃问题求助

一、解决“找不到函数定义”编译错误 #

1. 确认宏定义正确性
   若你自定义了ATTRIBUTE_ACCESSORS宏，必须保证其包含UE属性系统要求的所有函数声明，标准定义如下：

   #define ATTRIBUTE_ACCESSORS(ClassName, PropertyName) \
       GAMEPLAYATTRIBUTE_PROPERTY_GETTER(ClassName, PropertyName) \
       GAMEPLAYATTRIBUTE_VALUE_GETTER(PropertyName) \
       GAMEPLAYATTRIBUTE_VALUE_SETTER(PropertyName) \
       GAMEPLAYATTRIBUTE_VALUE_INITTER(PropertyName)
   

   缺失任意一行都会导致对应函数找不到定义。

2. 头文件依赖与类继承检查

   • 确保你的UAuraAttributeSet类继承自UAttributeSet，头文件开头需包含：

     #include "AttributeSet.h"
     #include "GameplayEffectTypes.h"
     

   • 类声明格式必须正确：

     UCLASS()
     class YOURPROJECT_API UAuraAttributeSet : public UAttributeSet
     {
         GENERATED_BODY()
     public:
         // 属性声明与宏调用
     };
     

3. 属性声明规范
   生命值/法力值必须声明为FGameplayAttributeData类型，且宏调用需紧跟属性声明：

   UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Attributes", ReplicatedUsing = OnRep_Health)
   FGameplayAttributeData Health;
   ATTRIBUTE_ACCESSORS(UAuraAttributeSet, Health)
   
   UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Attributes", ReplicatedUsing = OnRep_Mana)
   FGameplayAttributeData Mana;
   ATTRIBUTE_ACCESSORS(UAuraAttributeSet, Mana)
   

   注意宏的第二个参数必须与属性名完全一致。

二、解决调试模式运行崩溃问题 #

1. 验证Build.cs依赖配置
   项目的Build.cs必须添加GameplayAbilities相关模块，否则运行时会出现符号缺失崩溃：

   PublicDependencyModuleNames.AddRange(new string[] { 
       "Core", 
       "CoreUObject", 
       "Engine", 
       "GameplayAbilities", 
       "GameplayTags", 
       "GameplayTasks" 
   });
   

2. 实现属性复制与初始化

   • 在UAuraAttributeSet.cpp中实现GetLifetimeReplicatedProps，确保属性被正确复制：

     void UAuraAttributeSet::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
     {
         Super::GetLifetimeReplicatedProps(OutLifetimeProps);
     
         DOREPLIFETIME_CONDITION_NOTIFY(UAuraAttributeSet, Health, COND_None, REPNOTIFY_Always);
         DOREPLIFETIME_CONDITION_NOTIFY(UAuraAttributeSet, Mana, COND_None, REPNOTIFY_Always);
     }
     

   • 添加属性初始化逻辑，避免垃圾值访问崩溃：

     UAuraAttributeSet::UAuraAttributeSet()
     {
         Health.SetBaseValue(100.f);
         Health.SetCurrentValue(100.f);
         Mana.SetBaseValue(50.f);
         Mana.SetCurrentValue(50.f);
     }
     

   • 实现复制通知函数（可选但推荐，用于属性变化同步）：

     UFUNCTION()
     void OnRep_Health(const FGameplayAttributeData& OldHealth)
     {
         GAMEPLAYATTRIBUTE_REPNOTIFY(UAuraAttributeSet, Health, OldHealth);
     }
     
     UFUNCTION()
     void OnRep_Mana(const FGameplayAttributeData& OldMana)
     {
         GAMEPLAYATTRIBUTE_REPNOTIFY(UAuraAttributeSet, Mana, OldMana);
     }
     

3. 检查AttributeSet组件的创建
   在你的Character类中，必须确保UAuraAttributeSet被正确创建，避免空指针访问：

   AYourCharacter::AYourCharacter()
   {
       // 创建AttributeSet组件
       AuraAttributeSet = CreateDefaultSubobject<UAuraAttributeSet>(TEXT("AuraAttributeSet"));
   }
   

4. 利用调试日志定位崩溃点
   若仍崩溃，查看UE的Saved/Logs目录下的崩溃日志，找到调用栈的关键函数，比如：

   • 若崩溃在FGameplayAttributeData的访问函数，说明属性未初始化
   • 若崩溃在Cast操作，说明AttributeSet组件未正确挂载

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