Oozie调度Sqoop导出报错：Can not create a Path from an empty string

问题现象 #

• 手动场景验证全部通过：
  • 单独运行Sqoop基础命令（如list-tables）功能正常
  • 待执行的Sqoop导出命令直接在命令行执行全流程无报错
• Oozie调度运行时表现：
  • 前置流程无异常：可正常连接目标SQL Server表、完成列匹配校验、成功连通Hive元数据
  • 异常触发节点：MapReduce作业提交阶段
  • 抛出核心异常：java.lang.IllegalArgumentException: Can not create a Path from an empty string
  • 同步日志告警：SQOOP_HOME未设置
• 已附排查参考材料：完整错误堆栈、workflow.xml配置、job.properties配置、任务启动命令

根因说明 #

该异常与SQOOP_HOME未设置直接相关。
Sqoop提交MapReduce作业时，需要基于自身安装目录定位关联依赖jar包（包括Hive交互包、SQL Server驱动包等），再将这些包上传到HDFS临时作业目录供任务运行使用。当Oozie的执行上下文未加载到SQOOP_HOME变量时，Sqoop读取到的安装目录为空，拼接HDFS路径时就会因输入字符串为空触发上述异常。
手动执行命令时无报错，是因为本地shell环境已预配置SQOOP_HOME变量，Sqoop可正常读取安装路径。

修复步骤 #

• 在job.properties中显式定义Sqoop安装路径，不依赖系统环境变量的隐式加载，例如：
  sqoop.home.path=/usr/lib/sqoop
• 在workflow.xml的sqoop动作节点中，通过<env>标签将路径注入任务执行环境，确保Sqoop进程启动时可读取到SQOOP_HOME配置，示例配置：

  <env>SQOOP_HOME=${sqoop.home.path}</env>
  

• 全量检查配置中所有引用的路径变量，确认不存在未赋值就被引用的情况，避免触发额外的空Path异常
• 校验Oozie ShareLib配置，确认其中包含与当前集群版本匹配的sqoop、hive依赖，避免版本不匹配导致的路径解析异常

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