Elasticsearch GeoHashUtils库工作异常：同一GeoHash执行结果不稳定

问题现象 #

使用Elasticsearch 6.5.0/6.8.23版本的org.elasticsearch.common.geo.GeoHashUtils类调用bbox()方法时，出现同一GeoHash字符串有时执行成功、有时抛出异常的情况。测试代码及输出如下：

测试代码 #

public static void main(String[] args) {
    List<String> geoList = Arrays.asList("t9yu8v", "vtejpg", "t9yu8Y", "vtejpg", "t9yu8Y");
    for(String s : geoList) {
        try {
            GeoHashUtils.bbox(s);
            System.out.println("Success in " + s);
        } catch (Exception ex) {
            System.out.println("Exception in " + s);
        }
    }
}

执行输出 #

Output - 
Success in t9yu8v
Success in vtejpg
Exception in t9yu8Y
Success in vtejpg
Exception in t9yu8Y

注：含大写字母的GeoHash（如t9yu8Y）始终报错，合法GeoHash（如vtejpg）也可能出现偶发失败的情况。

核心原因 #

1. GeoHash字符合法性问题：标准GeoHash采用Base32编码，仅允许小写字母(a-z)和数字(0-9)，大写字母不属于合法字符集。t9yu8Y中的大写Y会直接触发非法参数异常。
2. 旧版本线程安全缺陷：Elasticsearch 6.x系列的GeoHashUtils内部使用了非线程安全的共享变量/缓存，当重复调用或多线程调用时，会导致内部状态混乱，进而引发合法GeoHash的偶发执行失败。

解决方案 #

1. 统一GeoHash为小写格式 #

将所有输入的GeoHash字符串转为小写，确保符合Base32编码规范：

// 修改调用处，统一转小写
GeoHashUtils.bbox(s.toLowerCase());

2. 升级Elasticsearch版本 #

6.x系列的GeoHashUtils存在线程安全问题，建议升级到7.x及以上版本，新版本已修复该缺陷，同时优化了GeoHash合法性校验逻辑。

3. 规避多线程共享调用（无法升级时的临时方案） #

若无法升级版本，需保证GeoHashUtils.bbox()在单线程环境下调用，或为每个线程独立处理请求，避免共享内部状态导致的异常。

验证修改后的代码 #

修改后的测试代码示例：

public static void main(String[] args) {
    List<String> geoList = Arrays.asList("t9yu8v", "vtejpg", "t9yu8Y", "vtejpg", "t9yu8Y");
    for(String s : geoList) {
        try {
            GeoHashUtils.bbox(s.toLowerCase());
            System.out.println("Success in " + s + " (converted to lowercase)");
        } catch (Exception ex) {
            System.out.println("Exception in " + s + ": " + ex.getMessage());
        }
    }
}

内容的提问来源于stack exchange，提问作者Tushar Arora