Ubuntu22.04中Zeppelin启动失败：XML配置加载异常+端口占用求助

1. 修复XML配置文件加载失败问题 #

Zeppelin不会读取带.template后缀的配置文件，必须先重命名模板文件：

cd $ZEPPELIN_HOME/conf
cp zeppelin-site.xml.template zeppelin-site.xml
cp zeppelin-env.sh.template zeppelin-env.sh

编辑zeppelin-site.xml，修改端口配置：

<property>
  <name>zeppelin.server.port</name>
  <value>9999</value>
  <description>Server port.</description>
</property>

可选：在zeppelin-env.sh中添加端口环境变量（与XML配置二选一即可，优先XML）：

export ZEPPELIN_PORT=9999

2. 验证端口可用性 #

启动前检查9999端口是否被占用：

sudo lsof -i :9999
# 或用netstat
sudo netstat -tulpn | grep 9999

若端口被占用，杀掉对应进程或更换其他未使用端口。

3. 确认环境变量生效 #

刷新~/.bashrc并验证配置：

source ~/.bashrc
echo $ZEPPELIN_HOME
echo $ZEPPELIN_PORT

确保ZEPPELIN_HOME指向Zeppelin安装目录，ZEPPELIN_PORT设为9999。

4. 重启Zeppelin并验证 #

先清理残留进程：

$ZEPPELIN_HOME/bin/zeppelin-daemon.sh stop
# 强制杀进程（若stop失败）
sudo pkill -f zeppelin

启动服务并查看日志：

$ZEPPELIN_HOME/bin/zeppelin-daemon.sh start
tail -f $ZEPPELIN_HOME/logs/zeppelin-*.log

访问http://127.0.0.1:9999确认界面可正常打开。

补充：排查8080端口占用 #

若需确认原8080端口占用进程：

sudo lsof -i :8080

通常Hadoop NameNode或Spark Master会占用该端口，这也是修改Zeppelin端口的核心原因。

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