Windows下HADOOP_HOME环境变量异常致Hadoop编译失败

核心问题分析 #

编译时提示package org.apache.hadoop.io does not exist，本质是javac命令无法找到Hadoop的依赖jar包，而终端无法正确识别HADOOP_HOME环境变量是主要诱因。

解决步骤 #

1. 正确配置Windows系统环境变量 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量区域（不是用户变量）操作：
  • 点击「新建」，变量名填HADOOP_HOME，变量值填你的Hadoop安装根目录（例：D:\hadoop-3.3.4，路径不要带空格）
  • 找到系统变量里的Path，点击「编辑」，添加两条路径：%HADOOP_HOME%\bin和%HADOOP_HOME%\sbin
• 点击「确定」保存所有设置，必须重启所有打开的终端窗口（CMD/PowerShell）才能让新环境变量生效

2. 验证环境变量是否生效 #

• 在CMD中执行：echo %HADOOP_HOME%，正常应输出你的Hadoop安装路径
• 在PowerShell中执行：echo $env:HADOOP_HOME，正常应输出你的Hadoop安装路径
• 如果仍无正确输出，检查环境变量是否保存、路径是否填写正确，重启电脑后再验证

3. 修正javac编译命令 #

Windows下编译时，classpath需要明确指定Hadoop的jar包路径，且用;分隔，示例命令：

javac -classpath "%HADOOP_HOME%\share\hadoop\common\hadoop-common-*.jar;%HADOOP_HOME%\share\hadoop\mapreduce\hadoop-mapreduce-client-core-*.jar;%HADOOP_HOME%\share\hadoop\common\lib\*.jar" -d classes src/*.java

• 注意用双引号包裹classpath，避免路径含空格导致解析错误
• *-*.jar是匹配对应目录下的版本jar包，确保和你的Hadoop版本一致

4. 关于IntelliJ能识别依赖的说明 #

IntelliJ是通过手动添加项目依赖库实现的，和系统环境变量无关，因此终端编译必须依赖正确的系统环境变量配置才能找到Hadoop jar包

内容的提问来源于stack exchange，提问作者Brahim Khalil Abid