Hue 4.10.0 Hive SQL编辑器使用非ASCII字符执行SQL报错如何解决

根因说明 #

该问题根因为Hue依赖的Python 2环境默认字符串为字节类型，多字节非ASCII字符（如韩文、中文等）在传输到Hive Server2时被截断为乱码，导致Hive SQL解析失败。相同SQL在Beeline中可正常执行说明Hive侧配置无异常，问题出在Hue的编码传输环节。

解决方案 #

方案1：修改Hue编码配置（优先尝试，无需修改源码） #

• 配置Hue启动环境变量
  编辑Hue启动脚本（通常为Hue安装目录下build/env/bin/hue，或对应systemd服务配置文件），在脚本最开头添加如下变量：

export PYTHONIOENCODING=utf-8
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

• 修改Hue核心配置文件
  打开desktop/conf/hue.ini，调整对应段落的配置项：

[desktop]
default_site_encoding = utf-8

[notebook]
force_utf8_encoding = true

[beeswax]
jdbc_driver_params = ;useUnicode=true;characterEncoding=utf-8

配置完成后重启Hue服务验证即可，90%以上的同类编码问题可通过该方案解决。

方案2：修改Hue源码适配编码（方案1无效时尝试） #

Python 2的默认字符串编码处理逻辑存在硬编码缺陷，需修改Hive交互逻辑的编码转换规则：
找到Hue安装路径下的desktop/libs/notebook/src/notebook/connectors/hive_server2_lib.py文件，定位到SQL语句传递的代码段，将原语句：

query = snippet['statement']

修改为：

query = snippet['statement'].encode('utf-8')

修改完成后重启Hue服务生效。

方案3：升级Hue运行的Python版本（长期解决方案） #

Hue 4.10.0完全兼容Python 3.6及以上版本，Python 3默认字符串为Unicode类型，原生不存在多字节字符编码截断问题，升级Python运行环境可彻底解决该类编码问题。

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