<think>我们正在处理一个关于Dinky运行
Flink 1
.17版本的
FlinkSQL时出现的类找不到异常：`
java.lang.ClassNotFoundException: org.apache.htrace
.core
.HTraceConfiguration`。
根据引用[1]中提到的类似问题（`
java.lang.NoClassDefFoundError`）的解决方法是导入
Flink的lib包，我们可以推测这个错误可能是由于缺少相关的依赖jar包引起的。
首先，我们需要明确HTrace是什么：
- HTrace是一个分布式跟踪工具，在
Hadoop生态中常用。在
Flink中，如果使用了某些与
Hadoop相关的功能（如HDFS连接器、
YARN资源管理等），可能会间接依赖HTrace。
但是，从
Flink 1
.15开始，
Flink已经移除了对HTrace的依赖，转而使用其他跟踪机制（如OpenTelemetry）。然而，在
Flink 1
.17中，我们仍然可能会遇到这个问题，特别是当我们在使用与
Hadoop兼容的组件时，因为
Hadoop本身可能依赖HTrace。
因此，这个错误表明在运行
FlinkSQL作业时，Dinky（或者底层的
Flink）需要加载`
org.apache.htrace
.core
.HTraceConfiguration`类，但该类不在classpath中。
解决方案：
1
. 添加HTrace的依赖到
Flink的lib目录。
我们可以下载HTrace的jar包并放入
Flink的lib目录中。由于
Flink在运行时会将lib目录下的jar包加载到classpath，这样就能解决类找不到的问题。
具体步骤：
a
. 访问Maven仓库，搜索`htrace-core`，选择与
Hadoop版本兼容的版本（因为HTrace通常与
Hadoop一起使用）。例如，
Hadoop 3
.x通常对应`htrace-core4`。
b
. 下载jar包，比如`htrace-core-3
.1
.0-incubating
.jar`（注意：版本需要根据实际需求选择，一般建议与
Hadoop版本匹配）。
c
. 将下载的jar包放入
Flink的lib目录（即`${
FLINK_HOME}/lib`）下。
d
. 重启
Flink集群（如果是在session模式下运行）以及Dinky服务，确保依赖被加载。
2
. 或者，通过Dinky的依赖管理添加HTrace依赖。
在Dinky中，我们也可以通过添加额外的依赖来引入HTrace。具体操作如下：
a
. 在Dinky的“集群管理”中，找到你使用的
Flink集群实例配置。
b
. 在“依赖管理”部分，添加HTrace的Maven依赖坐标。例如：
```xml
<dependency>
<groupId>
org.apache.htrace</groupId>
<artifactId>htrace-core</artifactId>
<version>3
.1
.0-incubating</version>
</dependency>
```
（注意：这里版本号需要根据实际情况选择）
c
. 保存配置并重启该集群实例（如果Dinky支持动态加载，可能需要重启Dinky服务）。
3
. 如果上述方法无效，考虑检查是否使用了过时的
Hadoop依赖版本。如果项目中使用了
Hadoop相关依赖，请确保
Hadoop版本与HTrace版本兼容。
4
. 另外，如果不想使用HTrace，可以考虑排除相关依赖（但需要确保排除后不影响功能）。例如，在Dinky的作业配置中，通过Maven的`<exclusion>`来排除HTrace依赖。但这种方法需要明确知道是哪个依赖引入了HTrace，否则可能无效。
注意事项：
- 在
Flink 1
.17中，官方文档并没有明确提到HTrace，因此这个依赖很可能是通过其他途径（如
Hadoop客户端）引入的。所以，请确保你的
Hadoop依赖版本与
Flink兼容，并且包含了所需的HTrace版本。
- 如果问题仍然存在，请检查Dinky的日志和
Flink的日志，确认是否还有其他类找不到的错误。
由于没有完整的错误堆栈，以上解决方案是基于常见情况的推测。如果问题复杂，可能需要进一步分析。
参考解决方案：[^1] 中提到的方法（导入lib包）实际上就是添加依赖到classpath，因此我们采取类似思路。
最后，建议：在解决问题后，最好记录完整的错误信息，以便日后排查。
如果上述方法不能解决，请提供更详细的错误日志。
§§相关问题§§
1
. 如何确定Dinky中
Flink作业的依赖冲突？
2
. 在Dinky中如何管理多个版本的
Flink集群？
3
. 如何为
Flink作业添加第三方依赖？
</think>### 解决 Dinky 中运行
Flink 1
.17 的
FlinkSQL 报错 `
java.lang.ClassNotFoundException: org.apache.htrace
.core
.HTraceConfiguration`
#### 问题分析
该错误表明
Flink 运行时缺少 `
org.apache.htrace
.core
.HTraceConfiguration` 类。HTrace 是
Hadoop 生态的分布式跟踪工具，
Flink 的 **
Hadoop 兼容组件**（如 HDFS 连接器或
YARN 资源管理）可能间接依赖此库。在
Flink 1
.17 中，官方未直接捆绑此依赖，需手动添加。
#### 解决方案
##### 方法 1：添加 HTrace 依赖到
Flink Lib 目录（推荐）
1
. **下载 HTrace 的 JAR 包**
- 访问 [Maven 仓库](https
://mvnrepository
.com/artifact/
org.apache.htrace/htrace-core)，选择兼容版本（推荐 `3
.1
.0-incubating`）。
- 直接下载链接：
```plaintext
https
://repo1
.maven
.org/maven2/
org/
apache/htrace/htrace-core/3
.1
.0-incubating/htrace-core-3
.1
.0-incubating
.jar
```
2
. **将 JAR 放入
Flink Lib 目录**
- 路径：`${
FLINK_HOME}/lib/`（例如 `/opt/
flink-1
.17
.0/lib`）。
3
. **重启
Flink 集群和 Dinky 服务**
```bash
# 重启
Flink Standalone 集群
${
FLINK_HOME}/bin/stop-cluster
.sh
${
FLINK_HOME}/bin/start-cluster
.sh
# 重启 Dinky
./dinky
.sh stop
./dinky
.sh start
```
##### 方法 2：通过 Dinky 依赖管理添加（集群未重启时）
1
. **在 Dinky 中添加依赖**
- 登录 Dinky → **集群管理** → 选择目标集群 → **作业 Jar 配置**
- 添加 Maven 依赖坐标：
```xml
<dependency>
<groupId>
org.apache.htrace</groupId>
<artifactId>htrace-core</artifactId>
<version>3
.1
.0-incubating</version>
</dependency>
```
2
. **重启作业**
- 重新提交
FlinkSQL 任务。
##### 方法 3：排除冲突依赖（若存在版本冲突）
若项目中其他组件（如 HBase）引入了旧版 HTrace，需在 Dinky 的依赖中排除：
```xml
<dependency>
<groupId>
org.apache.hbase</groupId>
<artifactId>hbase-client</artifactId>
<version>${hbase
.version}</version>
<exclusions>
<exclusion>
<groupId>
org.apache.htrace</groupId>
<artifactId>htrace-core</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 根本原因说明
- HTrace 是 **
Hadoop 生态的可选依赖**，
Flink 在访问 HDFS 或使用
YARN 时可能触发此需求。
-
Flink 1
.17 **未默认包含此库**，需手动添加。
- Dinky 提交任务时依赖
Flink 的 classpath，因此需确保
Flink 或作业依赖中包含 `htrace-core`[^1]。
#### 验证步骤
1
. 提交一个简单的 HDFS 读写任务测试：
```sql
CREATE TABLE hdfs_table (
id INT,
data STRING
) WITH (
'connector' = 'filesystem',
'path' = 'hdfs
://localhost
:9000/test',
'format' = 'csv'
);
INSERT INTO hdfs_table VALUES (1, 'test');
```
2
. 观察日志，确认无 `
ClassNotFoundException`。
> ⚠️ **注意**：若使用 CDH/HDP 等
Hadoop 发行版，需确保 `htrace-core` 版本与
Hadoop 兼容（如
Hadoop 3
.x 需 `htrace-core4`）。
本文介绍了在Flink运行于YARN集群时遇到的ClassNotFoundException问题，特别是关于org.apache.hadoop.yarn.api.ApplicationConstants$Environ的异常。问题根源在于Hadoop依赖库缺失，解决方案包括检查Flink与Hadoop版本兼容性、设置Flink环境变量以及重启Flink集群。遵循这些步骤，可以有效解决此类异常，确保Flink在大数据处理中的正常运行。
订阅专栏 解锁全文
扫一扫
553
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
