Apache SeaTunnel 及Web端安装常见问题及解决方法

本文是作者在安装Apache SeaTunnel过程中，新手可能会遇到的一些棘手问题总结，希望给到大家帮助和参考！

常见错误问题

java.lang.NoClassDefFoundError:com/sun/jersey/client/impl/CopyOnWriteHashMap

主要原因是，Hadoop相关的Jar包找不到，需要将Jar包放到lib下。

将atunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar到SeaTnnel的lib包下即可。

下载方法见文章后面的详细介绍：

SqlServer-cdc的Jar包安全问题

使用高版本的mssql的JDBC的Jar包时，有安全检查机制，会导致进行使用SeaTunnel的sqlserver-cdc时报异常：

lua 复制代码

Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

我使用的是mssql-jdbc-11.2.3.jre8.jar，结果一直报异常，添加了trustServerCertificate=true;encrypt=true参数也会报错（只针对seatunnel的SqlServer-cdc场景，在jdbc场景使用此jar包正常）。

经过查看源码与issue，发现源码中是低版本mssql-jdbc-9.4.1.jre8.jar，替换此Jar包后SqlServer-cdc在SqlServer2016上能够实现CDC功能。

有的同学使用的是mssql-jdbc-9.2.0.jre8.jar，也可以实现SqlServer-cdc功能。

Jar包下载地址 ：repo1.maven.org/maven2/com/...

SqlServer 2016无法开启表的CDC

安装进行开启SqlServer 2016的CDC功能时，遇到问题是： 以开启SqlServer的库的CDC，但是在开启表的CDC时，一直无法执行成功。

可能得原因是，计算机的名称发生了变化，需要将计算机的名称还原到安装SqlServer 2016的时候的名称。

**参考材料：**sql - 在表级别启用CDC时出错 - Thinbug: www.thinbug.com/q/23969742

mvn加速下载相关Jar包

安装SeaTunnel过程中，解压文件后官方默认提供的Connector的Jar包只有2个，要想连接MySQL、Oracle、SqlServer、Hive、Kafka、Clickhouse、Doris等时，还需下载对应的Jar包。

解决办法：

如果机器可以连接外网，可使用命令方式sh bin/install-plugin.sh直接下载，这个命令会自动下载文件apache-seatunnel-2.3.3/connectors/plugin-mapping.properties中指定的所有Connector的Jar包，每个人可根据自己情况自行增减需要的connector依赖包。

加速下载Connector相关Jar包

SeaTunnel下载Connector的Jar包时，从repo.maven.apache.org 下载，速度及其缓慢，且公司机器不能上外网，改用自己Windows本地的mvn，从阿里云mvn源下载情况会得到大大的改善。 解决办法：

修改其安装插件相关脚本，复制bin目录下install-plugin.sh重命名为install-plugin-mvn.sh

替换脚本中的${SEATUNNEL_HOME}/mvnw为mvn，即可使用本地mvn，配合阿里云的mvn源，可加速下载。

然后执行install-plugin-mvn.sh即可，我们可以看到原本2个小时没有下载完成的，改写后几分钟下载完成了。

将下载后的Jar包复制到connectors/seatunnel/下即完成connector的Jar包补充。

注意：在安装SeaTunnel的时候可能会出现java.lang.NoClassDefFoundError错误，大部分时候是因为缺少 Apache Hadoop的Jar包，在执行install-plugin-mvn.sh的时候会下载一个jar包seatunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar，存放于上一级目录的lib文件夹下。

如果是在其他路径下载jar包，将下载的seatunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar放在SeaTunnel的lib文件夹下，就可以解决这个问题了。