Corda对手方流内部错误求助：UnexpectedFlowEndException

看起来你在执行Corda交易流程时，卡在了公证人节点的交互环节——Kryo无法加载你的自定义State类，直接导致了公证人流终止，进而触发了UnexpectedFlowEndException。我来帮你一步步拆解排查：

1. 先确认State类的基础配置 #

• 确保com.demo.structures.State是public访问权限，而且类上标注了@CordaSerializable注解。Corda的序列化机制依赖这个注解来识别可序列化的类，没加的话Kryo会拒绝处理。
• 检查State类的所有成员字段，确保它们也都是可序列化的（要么是Corda内置类型，要么同样标注了@CordaSerializable）。

2. 验证公证人节点的Cordapp部署 #

这是最容易踩坑的点：

• 你必须把包含com.demo.structures.State类的Cordapp安装到公证人节点上。很多开发者只在交易参与方节点部署了Cordapp，忘了公证人也需要识别自定义状态类，直接导致类加载失败。
• 确保所有节点（发起方、对手方、公证人）的Cordapp版本完全一致，避免类结构不一致引发的序列化错误。

3. 检查序列化白名单配置 #

打开节点的serialization.conf文件（在Cordapp的src/main/resources目录下），确认你的State类所在的包被加入了序列化白名单：

cordapp {
    serialization {
        whitelist = [
            "com.demo.structures.*"
        ]
    }
}

如果白名单里没包含这个包，Kryo会拒绝加载该类，哪怕你加了@CordaSerializable。

4. 深挖公证人节点的日志细节 #

你看到的Kryo警告只是冰山一角，公证人节点的日志里肯定有更详细的错误信息（比如ClassNotFoundException的完整堆栈）。去公证人节点的logs目录下找最新的日志文件，搜索com.demo.structures.State，就能看到类加载失败的具体原因——是找不到类文件，还是类依赖缺失？

5. 检查FinalityFlow的调用逻辑 #

回到你的DealFlow和TradeFlow代码，确认调用FinalityFlow时：

• 传入的交易中包含的State实例是完整且合法的，没有未初始化的字段。
• 所有需要公证的状态都被正确添加到了交易中，没有遗漏或错误引用。

为什么会出现连锁错误？ #

当公证人节点收到交易后，尝试用Kryo反序列化你的State类，但因为上述某一个原因加载失败，直接抛出了未捕获的异常，导致公证人流强制终止。发起方的流程因为收不到公证人的响应，就抛出了UnexpectedFlowEndException——本质是公证人流崩溃导致的连接中断。

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