Apache Kyuubi 多地址配置解析问题分析与解决方案

问题背景

Apache Kyuubi 是一个开源的分布式 SQL 引擎，提供了 JDBC 接口和 SQL 执行能力。在最新版本 1.8.0 中，当用户配置 Atlas REST 服务的多个地址时，系统会出现 URI 解析错误，导致无法正常连接到 Atlas 服务。

问题现象

当在配置文件中设置多个 Atlas REST 服务地址时：

atlas.rest.address=http://bjbd-test-bigdata-atlas-002:21000,http://bjbd-test-bigdata-atlas-001:21000

系统会抛出以下异常：

java.lang.IllegalArgumentException: Illegal character in scheme name at index 0: [http://bjbd-test-bigdata-atlas-002:21000

问题根源分析

经过深入分析，发现问题的根本原因在于 Java 属性文件读取机制与字符串处理的差异：

1. Java 属性文件处理机制：当配置项包含多个值时，ApplicationProperties 类会将其解析为 Java List 对象。

2. List.toString() 方法行为：Java List 的 toString() 方法会在输出字符串前后添加方括号"[]"，例如 [http://host1:port1, http://host2:port2]。

3. URI 解析严格性：Java 的 URI 解析器对格式要求严格，无法处理包含方括号的 URL 字符串，导致解析失败。

技术细节

在底层实现上，Kyuubi 通过 AtlasBaseClient 类来连接 Atlas 服务。当客户端初始化时，会调用以下关键流程：

1. 从配置读取 REST 地址
2. 尝试建立连接
3. 选择活跃的服务地址

问题出现在第一步，当配置读取后，List 类型的地址被直接转换为字符串，包含了不必要的方括号，破坏了 URI 的标准格式。

解决方案

针对这个问题，社区已经提供了修复方案，主要改进点包括：

1. 正确处理 List 类型配置：在读取配置时，识别 List 类型并正确处理其中的多个地址。

2. 字符串清理：在将配置值传递给 URI 解析器前，移除任何可能干扰解析的特殊字符。

3. 地址分隔符标准化：确保多个地址间的分隔符符合标准，避免解析歧义。

最佳实践建议

对于使用 Kyuubi 与 Atlas 集成的用户，建议：

1. 升级到包含此修复的版本（1.8.0 之后的版本）

2. 如果暂时无法升级，可以采用以下临时解决方案：

   • 在配置中只指定一个 Atlas 服务地址
   • 自定义配置读取逻辑，手动处理多个地址的情况

3. 监控日志中的连接错误，确保服务发现机制正常工作

总结

这个问题展示了在分布式系统中处理配置项时需要考虑的细节问题。特别是在涉及网络地址和URI解析的场景下，格式的严格性不容忽视。Apache Kyuubi 社区对此问题的快速响应和修复，体现了开源项目对用户体验的重视。

通过这个案例，我们也学习到在开发类似功能时，应该充分考虑配置值的各种可能格式，并做好相应的兼容处理，以增强系统的鲁棒性。