Apache Zeppelin 0.11.1执行段落触发InterpreterException问题求助

错误根源 #

从错误堆栈可以定位到核心问题：Zeppelin尝试加载._spark-interpreter-0.11.1.jar时触发java.util.zip.ZipException，这个文件是Mac系统生成的AppleDouble格式隐藏元数据文件，并非合法的JAR包，被类路径扫描误识别后导致加载失败。

一、二进制部署场景修复步骤 #

1. 清理Zeppelin目录下所有._开头的无效文件

   find /projects/zeppelin-v2/zeppelin-0.11.1-bin-all -name "._*.jar" -delete
   

2. 重启Zeppelin服务

   ./bin/zeppelin-daemon.sh stop
   ./bin/zeppelin-daemon.sh start
   

二、Docker部署场景修复步骤 #

问题源于本地挂载目录中存在Mac生成的隐藏文件，需清理并避免后续生成：

1. 停止运行的Zeppelin容器

   docker stop zeppelin
   

2. 清理本地挂载目录中的._开头文件

   find /projects/zeppelin -name "._*.jar" -delete
   

3. （可选）若文件从Mac复制到服务器，先在Mac端清理元数据再复制

   # 在Mac终端执行，清理本地待复制目录的元数据
   xattr -rc /本地待复制的Zeppelin相关目录
   

4. 重新启动Docker容器
   使用原启动命令即可。

验证方法 #

启动Zeppelin后，在笔记本中执行以下代码验证：

sc.version

若返回3.5.1，则说明问题已解决。

内容的提问来源于stack exchange，提问作者Lino.1710