Puerts项目中的UE Mixin基类PIE二次启动崩溃问题分析

问题现象

在Unreal Engine 5.3环境下使用Puerts 1.0.6.1版本时，开发者遇到了一个特定场景下的崩溃问题。具体表现为：

1. 创建了一个继承层级：BP_BaseDerive继承自BP_Base，BP_Base继承自Pawn
2. 对BP_Base类进行了Mixin操作，重写了ReceiveBeginPlay和ReceiveTick函数
3. 运行时通过Spawn创建BP_BaseDerive实例
4. 第一次PIE(Play In Editor)运行正常
5. 停止PIE后再次启动PIE时，游戏崩溃

崩溃时的错误信息显示为EXCEPTION_ACCESS_VIOLATION读取非法内存地址，调用栈显示在UObjectBaseUtility::GetPathName处发生崩溃。

技术背景

在Unreal Engine中，Mixin是一种将脚本功能混合到原生类中的技术。Puerts通过Mixin机制允许TypeScript代码重写UE类的函数。UClass内部会缓存查找过的函数以提高性能，这种缓存机制在正常情况下工作良好。

问题根源

经过深入分析，发现问题出在UClass的函数查找缓存机制与Mixin清理逻辑的交互上：

1. UClass::FindFunctionByName会将查找结果缓存起来以提高后续查找效率
2. 当清理Mixin时，现有代码只清理了当前类的函数缓存
3. 但未清理该类的子类缓存
4. 导致子类后续可能查找到已经过期的UFunction对象
5. 当引擎尝试使用这些无效的函数对象时，最终引发了内存访问违例

解决方案

修复方案的核心思路是：在清理Mixin时，不仅要清理当前类的函数缓存，还需要递归清理所有子类的相关缓存。这确保了：

1. 所有相关的缓存条目都被正确清除
2. 后续的函数查找会得到正确的结果
3. 避免了使用过期的函数对象

经验总结

这个案例揭示了几个重要的开发经验：

1. 缓存机制虽然能提高性能，但必须与对象的生命周期管理严格同步
2. 在继承体系中，对父类的操作可能需要考虑对子类的影响
3. UE引擎内部的缓存机制需要特别关注，特别是在动态修改类结构的场景下
4. PIE模式下的二次运行问题往往能暴露出一系列生命周期管理问题

最佳实践建议

基于此问题的经验，建议开发者在处理类似场景时：

1. 充分理解UE的类缓存机制
2. 在修改类结构时，考虑继承体系的影响
3. 对PIE模式下的多次运行进行充分测试
4. 在实现Mixin等动态修改类功能时，确保清理逻辑的完整性

这个问题虽然表面现象复杂，但通过分析调用栈和了解引擎内部机制，最终定位到了缓存管理这一根本原因，为类似问题的排查提供了有价值的参考。