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
相关产品推荐
相关产品推荐

