变更CorDapp中作为状态参数的数据类文件位置是否可行？

结论先行：在已有旧数据的环境中，移动作为State参数的Data Class文件位置（即修改其包结构），几乎一定会触发反序列化错误，导致旧数据无法正常加载，不建议直接操作。

核心原因 #

Corda的序列化机制是通过类的全限定类名（包名+类名）来唯一识别序列化类型的。当你把Data Class从一个包移到另一个包，哪怕类名完全不变，它的全限定类名也会发生变化：

• 旧数据在存储时，是用原全限定类名标记该Data Class类型的；
• 新版本CorDapp尝试反序列化旧数据时，会根据存储的旧类名去查找对应类型，找不到新位置的类，直接抛出反序列化异常。
  这种逻辑和你提到的“移动State/Contract类会被视为全新类型”完全一致——只要全限定类名变了，Corda就会把它当成不同的类型处理。

若必须调整的兼容方案 #

如果业务上确实需要调整包结构，必须提前做序列化兼容处理：

• 在新位置的Data Class上添加@CordaSerializable(asOriginal = "<旧全限定类名>")注解，明确告诉Corda序列化器：这个新类是旧类的兼容替代类型；
• 确保所有运行中的节点都升级到包含该兼容注解的CorDapp版本后，再逐步完成旧数据的重新序列化（比如通过发起一笔交易更新状态），避免节点间出现序列化不兼容的情况。

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