Apache Kyuubi引擎WebUI终止功能失效问题分析

Apache Kyuubi作为开源的大数据SQL网关服务，其WebUI管理界面提供了便捷的引擎管理功能。但在1.9.2和1.10.0版本中，用户发现通过WebUI终止引擎时，虽然界面显示所有会话和操作已停止，但实际引擎进程并未真正退出。

问题现象

当管理员通过Kyuubi WebUI界面执行引擎终止操作后，界面反馈操作成功，所有会话状态显示为已终止。然而在引擎日志中持续输出"1 connection(s) are active, delay shutdown"的警告信息，表明引擎检测到仍有活跃连接存在，因此延迟关闭流程。

根本原因分析

通过分析引擎日志和源代码，发现问题出在服务发现模块的会话计数机制上。当WebUI触发终止操作时，虽然实际会话已被关闭，但activeSessionCount计数器未能及时更新，导致引擎错误地认为仍有活跃会话存在。

在服务发现模块的核心逻辑中，存在一个while循环用于检查活跃会话数。当计数器未正确更新时，该循环将持续运行，阻止引擎正常关闭流程。这种状态会一直持续，直到达到kyuubi.session.engine.idle.timeout设置的空闲超时时间后，引擎才会强制终止。

解决方案建议

针对此问题，建议从以下几个方面进行修复：

1. 在WebUI终止操作触发时，确保同步更新活跃会话计数器
2. 增加会话状态变更的原子性操作，避免计数不一致
3. 完善日志输出，在延迟关闭时记录更详细的会话信息
4. 考虑增加强制终止选项，允许管理员绕过会话检查

最佳实践

对于当前使用受影响版本的用户，可以采取以下临时解决方案：

1. 通过YARN ResourceManager直接终止对应的应用程序
2. 适当调低kyuubi.session.engine.idle.timeout参数值
3. 定期检查并清理长时间运行的引擎进程

该问题的修复将显著提升Kyuubi引擎管理的可靠性和用户体验，特别是在生产环境中的运维管理场景下。建议用户关注后续版本更新，及时升级以获得更稳定的引擎管理功能。