beeline 连接 Kyuubi 失败

现象：连接报ZooKeeper 中找不到 kyuubi 节点或连接超时。

处理步骤：

1、检查是否已通过 kinit 完成 Kerberos 认证；

2、检查连接串中 zooKeeperNamespace 是否与服务端 kyuubi.ha.namespace 一致（默认 kyuubi）；

3、检查 principal 与服务端配置是否一致，注意大小写与 realm。

连接成功但引擎启动失败

现象：连接建立后长时间无响应，最终报引擎启动超时或失败。

处理步骤：

1、通过 YARN 查看引擎 application 状态与日志，确认是否资源不足或队列排队；

2、检查引擎内存等资源配置是否超出队列上限；

3、检查 /var/log/kyuubi 下服务日志中的异常堆栈。

连接串追加参数不生效

现象：追加的kyuubi 或 spark 参数未按预期生效。

处理步骤：

1、kyuubi 参数需使用 ;# 前缀追加，spark 参数需使用 ? 前缀追加，多个参数用分号分隔；

2、检查参数名与取值拼写；

3、按用户定制的 ___<user>___.spark 参数配置在 kyuubi-defaults.conf 时，修改后需要重启 kyuubi 服务。

不同连接之间互相影响

现象：一个连接上的大任务导致同一用户其他查询变慢。

处理：为不同业务使用不同的kyuubi.engine.share.level.subdomain 隔离引擎，或将共享级别调整为 CONNECTION，使每个连接独享引擎。

SQL 语法报错（与 Hive 语法差异）

现象：原本在Hive 上可执行的 SQL 提交到 Kyuubi 后语法报错。

处理：Kyuubi 当前集成的是 spark-sql 语法，与 Hive 语法存在差异（如分桶表、部分函数行为等），请参考 spark 使用手册或官网 sql 语法调整 SQL。