已引入hadoop/*-common.jar仍报org.apache.hadoop.conf.Configuration类找不到

我之前在搭建Hadoop RPC示例时也碰到过一模一样的报错——明明确认hadoop-common.jar里包含目标类，但运行时还是找不到。大概率是运行时类路径没有正确加载到相关依赖，给你几个具体的排查和解决方向：

1. 优先确认运行时类路径是否完整 #

编译时能找到类不代表运行时能找到。如果是用命令行手动运行，一定要确保java命令的-classpath参数包含：

• 对应版本的hadoop-common.jar（比如hadoop-common-3.3.4.jar）
• Hadoop common依赖的所有第三方jar包（可以在Hadoop安装目录的share/hadoop/common/lib下找到）

示例运行命令参考：

java -classpath .:/path/to/hadoop/share/hadoop/common/hadoop-common-3.3.4.jar:/path/to/hadoop/share/hadoop/common/lib/* rpc.RPCServer

2. 检查IDE的运行配置（如果用IDEA/Eclipse） #

如果是在IDE中运行，很可能是模块依赖没配置到位：

• 确保已经把Hadoop的common模块（或对应的jar包）添加到项目的运行时依赖中，而不只是编译依赖
• 在IDEA中可以通过File -> Project Structure -> Modules -> Dependencies检查，把Hadoop相关jar的Scope设为Compile或Runtime
• 清理IDE缓存并重新构建项目（IDEA：File -> Invalidate Caches...）

3. 核对Hadoop版本兼容性 #

不同版本的Hadoop可能包结构有细微调整，确认你代码中导入的org.apache.hadoop.conf.Configuration和你使用的Hadoop版本中的类路径完全一致。比如Hadoop 2.x和3.x的common包结构基本一致，但如果是更老的1.x版本，需要额外确认。

4. 检查构建工具的依赖配置（如果用Maven/Gradle） #

如果是用Maven管理依赖，检查pom.xml中Hadoop common的依赖是否正确，且没有错误设置scope：

<dependency>
    <groupId>org.apache.hadoop</groupId>
    <artifactId>hadoop-common</artifactId>
    <version>你的Hadoop版本号</version>
    <!-- 本地运行时不要设为provided，否则IDE不会自动加载该jar -->
    <scope>compile</scope>
</dependency>

Gradle对应的配置：

implementation 'org.apache.hadoop:hadoop-common:你的版本号'

5. 辅助排查：打印当前运行时类路径 #

如果以上方法都没解决，可以在main方法开头加入这段代码，确认运行时是否真的加载了目标jar：

System.out.println(System.getProperty("java.class.path"));

运行后查看输出，检查是否包含hadoop-common.jar的完整路径。

内容的提问来源于stack exchange，提问作者lf.D