常见问题

报错：Discovery failed: java.lang.InternalError: java.lang.reflect.InvocationTargetException - Root cause: java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration

• 原因：运行环境没有安装字体和字体管理工具，导致结果无法输出到Excel。

• 解决方案：在运行环境安装 fontconfig 和一套常用字体 (dejavu)

  • CentOS / RHEL / Fedora: sudo yum install -y fontconfig dejavu-sans-fonts

  • Debian / Ubuntu: sudo apt-get update &&apt-get install -y fontconfig fonts-dejavu

  • Alpine Linux: sudo apk add --no-cache fontconfig ttf-dejavu

报错：获取HiveMetaStoreClient失败, uri:thrift://**.**.**.***:9083, error:Could not connect to meta store using any of the URIs provided. Most recent failure: org.apache.thrift.transport.TTransportException: java.net.ConnectException: Connen refused

• 原因：防火墙 / 安全组 / 网络策略未放行 9083 端口，导致无法连接。

• 解决方案：

1) 从执行 lhm 的机器测试连通性

telnet <metastore_host> 9083
# 或
nc -vz <metastore_host> 9083

2) 在对应防火墙或云安全组中，放行 Hive MetaStore 端口（默认 9083），允许执行离线工具的服务器访问

• 源：离线工具运行服务器的 IP 或网段

• 目的：Hive MetaStore 主机

• 端口：9083（或实际配置端口）

• 协议：TCP