Sqoop导入抛出java.lang.ClassNotFoundException: Class orders未找到

问题重现 #

在Ubuntu 22.04搭建的Hadoop环境中，执行Sqoop导入MySQL classicmodels.orders表的命令：

sqoop import --table orders --connect jdbc:mysql://localhost:3306/classicmodels --username hadoop -password 1234 --target-dir /BigData/Sample/Orders/myBirthdayOrders.txt --where "orderDate = '2003-02-17'" --outdir ./libjars --bindir ./libjars

执行后抛出类找不到异常：

Java.lang.Exception: java.lang.RuntimeException: java.lang.ClassNotFoundException: Class orders not found
    at org.apache.hadoop.mapred.LocalJobRunner$Job.runTasks(LocalJobRunner.java:492)
    at org.apache.hadoop.mapred.LocalJobRunner$Job.run(LocalJobRunner.java:552)
...

但libjars目录下已存在生成的类文件。

核心原因 #

1. 类名不匹配：Sqoop默认会将小写表名转换为驼峰式类名（如orders表生成Orders.class），但任务运行时尝试加载的是小写的orders类，导致找不到。
2. ClassPath未包含类文件目录：--bindir仅指定.class文件的输出目录，但Sqoop启动MapReduce任务时，不会自动将该目录加入任务的ClassPath，因此无法加载到生成的类。

解决方案 #

方案1：强制指定类名与表名一致 #

修改Sqoop命令，添加--class-name orders参数强制生成小写类名，同时将类文件打包为jar并指定加载：

# 先将libjars下的类文件打包为jar
cd libjars
jar cvf orders.jar *.class

# 执行修改后的Sqoop命令
sqoop import --table orders --class-name orders --connect jdbc:mysql://localhost:3306/classicmodels --username hadoop -password 1234 --target-dir /BigData/Sample/Orders/myBirthdayOrders.txt --where "orderDate = '2003-02-17'" --outdir ./libjars --bindir ./libjars --jar-file ./libjars/orders.jar

方案2：让Sqoop自动处理类打包（无需手动指定目录） #

如果不需要保留生成的类文件，可去掉--bindir和--outdir参数，让Sqoop自动完成类的打包与加载：

sqoop import --table orders --connect jdbc:mysql://localhost:3306/classicmodels --username hadoop -password 1234 --target-dir /BigData/Sample/Orders/myBirthdayOrders.txt --where "orderDate = '2003-02-17'"

方案3：手动将类目录加入Hadoop ClassPath #

将libjars目录添加到Hadoop的ClassPath后再执行Sqoop命令：

export HADOOP_CLASSPATH=$HADOOP_CLASSPATH:/path/to/libjars
sqoop import --table orders --connect jdbc:mysql://localhost:3306/classicmodels --username hadoop -password 1234 --target-dir /BigData/Sample/Orders/myBirthdayOrders.txt --where "orderDate = '2003-02-17'" --outdir ./libjars --bindir ./libjars

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