Streamsets DataCollector中Groovy Evaluator导入外部Java库报错

报错的直接触发原因 #

• 从错误提示和堆栈信息可以定位，最先触发异常的是代码层面的类名引用错误：你通过import ch.hsr.geohash.GeoHash导入的类名，尾段为大写H开头的GeoHash，但在代码实际调用时写的是小写h开头的Geohash。Groovy的动态语法在无法匹配到对应类定义时，会将你写的Geohash识别为脚本内未定义的属性，直接抛出MissingPropertyException，这个异常和是否成功导入外部库没有直接关联。类名大小写不匹配是当前报错的核心触发点。
• 代码修正参考：所有调用GeoHash类的位置，严格保持和import语句一致的大小写规则，例如正确的静态方法调用写法为GeoHash.withCharacterPrecision(lat, lon, 12)，禁止错写为Geohash.xxx()。

完成代码修正后需核对的库加载配置 #

调整完类名大小写后，若仍出现类加载失败问题，基本是External Libraries的配置未满足Streamsets的类加载规则，需逐一核对以下配置项：

• 检查导入的jar包完整性：geohash 1.4.0版本存在传递依赖，单独导入核心jar包而未附带其依赖的工具类，会在方法调用环节触发NoClassDefFoundError。需要将geohash核心包及其所有传递依赖的jar包，全部上传到External Libraries列表中。
• 确认配置生效：所有External Libraries的新增、修改操作，必须重启DataCollector服务后才会被类加载器识别。上传jar后直接预览流水线，会因为类加载器未刷新，无法加载到新传入的类。
• 避免类冲突：不要将第三方jar手动放到DataCollector安装目录的系统lib路径下，必须通过管理后台的External Libraries入口上传，否则可能和系统内置的依赖版本产生冲突，导致类加载异常。

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