Hazelcast项目Jet实例类路径多ZIP文件加载问题分析

问题背景

在Hazelcast项目的Jet模块中，用户代码命名空间(User Code Namespaces)功能允许用户将自定义JAR包添加到Jet实例的类路径中。近期一个代码变更导致了无法向Jet实例的类路径中添加多个包含JAR文件的ZIP压缩包的问题。

问题现象

当尝试通过JobConfig的addJarsInZip方法添加多个ZIP文件时，系统会抛出"Resource with id:null already exists"的异常。这个问题出现在用户需要加载多个包含不同JAR文件的ZIP压缩包时，严重影响了功能的正常使用。

技术分析

变更影响

问题的根源在于一个代码变更将资源ID设置为null。在变更前，系统使用ZIP文件的最后路径段(文件名)作为资源ID，这种设计允许多个ZIP文件共存，因为每个文件名都是唯一的。变更后，所有ZIP文件都被赋予null作为资源ID，导致系统无法区分不同的ZIP文件资源。

资源管理机制

Hazelcast的JobConfig类内部使用一个Map来存储资源，其中资源ID作为键。当多个资源尝试使用相同的ID(null)注册时，系统会检测到冲突并抛出异常。这种设计原本是为了防止资源重复加载，但在处理多个ZIP文件时产生了负面效果。

测试用例分析

测试用例清晰地展示了这个问题：

1. 尝试添加两个不同的ZIP文件(person-jar.zip和person-car-jar.zip)
2. 由于两者资源ID都为null，第二次添加时触发异常
3. 测试失败，无法完成多ZIP文件的加载

解决方案建议

恢复原有设计

最直接的解决方案是恢复使用ZIP文件名作为资源ID的设计。这种方法：

1. 保证每个ZIP文件有唯一标识
2. 与原有功能兼容
3. 实现简单，风险低

替代方案考虑

也可以考虑其他资源标识方案，如：

1. 自动生成UUID作为资源ID
2. 使用ZIP文件的完整路径作为ID
3. 引入复合ID机制

但这些方案可能带来额外的复杂性，且不如文件名方案直观。

影响评估

这个问题主要影响以下场景：

1. 需要加载多个独立ZIP文件的用户
2. 依赖动态资源加载的应用
3. 使用模块化JAR包部署的场景

对于大多数简单用例(单个ZIP文件)不受影响。

总结

Hazelcast Jet实例类路径的多ZIP文件加载问题源于资源ID管理策略的变更。恢复使用ZIP文件名作为资源ID是最合理的解决方案，既能解决问题，又能保持系统的简洁性和一致性。开发团队应优先考虑此修复方案，以确保用户能够正常使用多ZIP文件加载功能。