You need to enable JavaScript to run this app. Zeppelin 0.9.0配置Shiro JDBC Realm时MysqlDataSource类加载失败
优惠活动
大模型
产品
解决方案
定价
更多

Zeppelin 0.9.0配置Shiro JDBC Realm时MysqlDataSource类加载失败

Shiro JDBC Realm 类加载失败问题定位与修复

核心报错根因

  • 类加载路径失效:Zeppelin 0.9.0 的启动脚本会自行维护主进程的类加载路径,手动设置的CLASSPATH环境变量会被启动逻辑覆盖,Shiro模块作为Web层组件,使用的是Web上下文类加载器,不会主动扫描环境变量中指定的Jar路径。
  • 类名版本不匹配:使用的mysql-connector-java-6.0.4版本中,老版本的com.mysql.jdbc.jdbc2.optional.MysqlDataSource类为兼容过渡类,即便Jar被加载,也存在被标记为废弃、类路径偏移的可能。
  • 配置逻辑冲突:shiro.ini 中重复定义了两次jdbcRealm.credentialsMatcher,先配置Sha256凭证匹配器,后又被PasswordService匹配器覆盖,会在类加载问题解决后触发后续的认证逻辑异常。
  • 环境配置疏漏:K8s部署场景下,shiro.ini 中配置的ds.serverName = localhost指向Zeppelin Pod自身,并非MySQL服务地址,即便类加载问题解决,也会出现数据库连接失败。

修复步骤

1. 调整自定义Docker镜像的Jar包加载逻辑

不要依赖CLASSPATH环境变量加载驱动,直接将驱动Jar放置到Zeppelin主进程自动扫描的${Z_HOME}/lib目录下,修正后的Dockerfile核心逻辑:

ARG ZEPPELIN_IMAGE=apache/zeppelin:0.9.0
FROM ${ZEPPELIN_IMAGE}
WORKDIR ${Z_HOME}

# 拷贝Shiro配置文件到指定配置目录
COPY ./zeppelin/shiro.ini ${Z_HOME}/conf/

# 下载MySQL驱动到Zeppelin自动扫描的lib目录,设置正确的文件权限
RUN curl -o ${Z_HOME}/lib/mysql-connector-java-6.0.4.jar 对应驱动下载地址 \
    && chmod 644 ${Z_HOME}/lib/mysql-connector-java-6.0.4.jar

# 保持原有启动入口逻辑不变
ENTRYPOINT [ "/usr/bin/tini", "--" ]
CMD ["bin/zeppelin.sh"]

注:无需额外配置CLASSPATH环境变量,Zeppelin启动时会自动加载lib目录下所有Jar文件到主进程类路径

2. 修正shiro.ini配置内容

替换适配版本的类名、删除重复配置、修正数据库连接地址:

[main]
# 替换为6.0.4版本驱动对应的正式DataSource类路径
ds = com.mysql.cj.jdbc.MysqlDataSource
# 替换为K8s环境中MySQL服务的实际访问地址,不要使用localhost
ds.serverName = MySQL服务实际地址
ds.databaseName = zeppelin
ds.user = zeppelin
ds.password = 数据库访问密码

jdbcRealm = org.apache.shiro.realm.jdbc.JdbcRealm
ps = org.apache.shiro.authc.credential.DefaultPasswordService
pm = org.apache.shiro.authc.credential.PasswordMatcher
pm.passwordService = $ps
jdbcRealm.dataSource = $ds
jdbcRealm.credentialsMatcher = $pm

# 可选:根据实际数据库表结构自定义认证、鉴权查询语句,覆盖JdbcRealm默认查询逻辑
# jdbcRealm.authenticationQuery = SELECT password FROM 用户表 WHERE username = ?
# jdbcRealm.authorizationQuery = SELECT 角色名 FROM 角色关联表 WHERE username = ?

shiro.loginUrl = /api/login

[urls]
/** = authc

验证排查命令

  • 进入Zeppelin Pod内部,执行以下命令确认驱动Jar已被加载到主进程类路径:
    jcmd $(pgrep -f zeppelin) VM.system_properties | grep java.class.path
    若输出内容中包含mysql-connector-java-6.0.4.jar的路径,说明类加载配置生效。
  • 在Pod内测试MySQL服务连通性:确认K8s NetworkPolicy、Service配置允许Zeppelin Pod访问MySQL的3306端口,不存在网络拦截。

内容的提问来源于stack exchange,提问作者JDev

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 00:24:04