UE4.19迁移至4.26时FProperty序列化函数SerializeItem调用编译报错问题咨询

结论 #

你需要的等效接口为FProperty::Serialize(FArchive& Ar, void* Value)，和4.19版本SerializeItem的功能、序列化格式完全一致，不需要修改整个存档系统逻辑。

注意：你当前临时使用的Property->Serialize(Ar)写法是错误的，该重载是UObject的序列化方法，漏传了属性地址参数，会导致序列化异常甚至崩溃。

接口变更背景 #

UE在4.20~4.21版本迭代中为新增结构化存档功能重构了序列化框架：

• 原有接收FArchive&参数的SerializeItem接口被移除，新增的SerializeItem(FStructuredArchive::FSlot Slot, void* Value)仅用于结构化序列化场景
• 原普通FArchive的单属性序列化逻辑被合并到FProperty::Serialize(FArchive& Ar, void* Value)重载中，内部实现和旧版SerializeItem完全对齐，无逻辑差异

修正后的代码 #

FProperty** PropertyPtr = SaveGameProperties ? SaveGameProperties->Find(PropertyName) : nullptr;
FProperty* Property = PropertyPtr ? *PropertyPtr : nullptr;
if( Property )
{
    uint8* PropertyAddr = Property->ContainerPtrToValuePtr<uint8>(&Object);
    // 替换原SerializeItem调用，传入存档实例和属性内存地址两个参数
    Property->Serialize(Ar, PropertyAddr);
}
else
{
    ensure(false);
    Ar.Seek(SkipOffset);
}

兼容说明 #

• 该接口为引擎官方保留的稳定接口，序列化输出格式和旧版SerializeItem完全一致，兼容历史存档数据
• 引擎内置的SaveGame、蓝图属性序列化等官方场景，在版本升级后也统一采用该接口实现单属性序列化，稳定性有保障

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