Kubernetes环境执行Hazelcast任务报序列化异常如何解决

本地单节点运行正常，是因为你启动的Hazelcast实例和提交任务的代码运行在同一个JVM进程内，执行executor.submit()时不需要跨进程序列化传输InfoTask类，JVM可以直接从当前类路径加载到InfoTask，不会触发类加载失败。
迁移到Kubernetes集群后，Hazelcast是多节点分布式部署，你提交的InfoTask需要经过网络序列化后传输到其他集群节点执行，而目标节点的JVM类路径中不存在my.hazelcast.InfoTask这个类，反序列化阶段触发ClassNotFoundException，最终包装为HazelcastSerializationException抛出。

• 类路径预部署（生产环境首选方案）
  构建Hazelcast集群镜像时，直接将包含InfoTask类的业务Jar包放入Hazelcast的类加载目录（通常为${HAZELCAST_HOME}/lib），保证集群所有节点都能在启动时加载到任务类。该方案无额外性能开销，稳定性最高，适合生产环境使用。
• 开启用户代码部署功能（无需提前预部署Jar）
  开启Hazelcast原生的User Code Deployment特性，集群配置示例：

  hazelcast:
    user-code-deployment:
      enabled: true
      class-cache-mode: ETERNAL
  

  配置生效后，客户端提交任务时会自动将InfoTask的类字节码传输到待执行的目标节点，节点通过动态类加载机制加载该类，无需提前将业务Jar放到所有节点的类路径下。使用该方案需要严格控制业务类的版本，避免不同版本的同名类提交到集群引发类冲突。
• 任务逻辑与参数分离（轻量场景可选）
  如果不想动态传输类，也可以将InfoTask的执行逻辑提前部署到所有集群节点，客户端提交任务时只传递任务类型标识和入参，节点收到请求后根据标识匹配本地已加载的任务实现，传入参数执行即可，整个传输过程不涉及自定义任务类的序列化。

• 为何官方Executor Service章节未提及任务序列化要求？
  跨JVM传输的对象必须可序列化、且接收方JVM可加载到对应类，是所有分布式Java组件的通用基础规则，Hazelcast将这部分规则统一放在序列化章节做说明，Executor Service作为上层功能组件，不会重复赘述分布式通信的底层通用要求。本地单节点模式不存在跨JVM通信，因此不会触发序列化校验，本地调试时感知不到这个约束。
• 不将任务Jar添加到类路径，如何避免序列化异常？
  直接使用上文提到的用户代码部署（User Code Deployment）特性即可，该特性就是为动态下发业务代码的场景设计的，不需要提前在所有节点放置业务Jar，客户端提交任务时会自动完成类字节码的同步，节点动态加载类后即可正常反序列化、执行任务。

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