WSL下Ubuntu 22.04安装Hadoop 3.3.5报错：Invalid HADOOP_COMMON_HOME

问题原因 #

Hadoop 3.x版本的部分启动脚本依赖HADOOP_COMMON_HOME环境变量，你的.bashrc仅配置了HADOOP_HOME，脚本无法正确识别公共组件路径，因此抛出错误。

修复步骤 #

1. 修改.bashrc配置
   打开~/.bashrc文件，添加HADOOP_COMMON_HOME变量（直接指向HADOOP_HOME即可兼容Hadoop 3.x的路径逻辑）：

   export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-amd64
   export HADOOP_HOME=~/hadoop/hadoop-3.3.5
   export HADOOP_COMMON_HOME=$HADOOP_HOME
   export PATH=$PATH:$HADOOP_HOME/bin
   export HADOOP_CONF_DIR=$HADOOP_HOME/etc/hadoop
   

2. 让配置立即生效
   在终端执行以下命令，无需重启终端即可加载新配置：

   source ~/.bashrc
   

3. 验证变量设置
   执行命令确认HADOOP_COMMON_HOME已正确配置：

   echo $HADOOP_COMMON_HOME
   

   正常输出应为你的Hadoop安装路径~/hadoop/hadoop-3.3.5

4. 重新执行格式化命令
   切换到Hadoop安装目录，再次运行格式化命令：

   bin/hdfs namenode -format
   

额外注意事项 #

• 建议将HADOOP_HOME改为绝对路径（例如/home/你的用户名/hadoop/hadoop-3.3.5，替换为实际用户名），避免WSL中部分脚本对~路径解析出错
• 提前通过ls ~/hadoop/hadoop-3.3.5确认安装目录存在，且包含bin、etc/hadoop等必要子目录

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