你碰到的Exception in thread "main" java.lang.ClassNotFoundException: WordCount问题，并不是Maven构建的JAR本身和Hadoop不兼容，只是打包环节缺少了关键配置，导致Hadoop找不到你的主类而已。下面是具体的排查和解决方法：

1. 给pom.xml补上主类配置 #

Hadoop需要明确知道JAR的入口类，你可以通过Maven的maven-jar-plugin在pom.xml中配置主类信息，这样打包后的JAR会自动携带主类元数据，Hadoop就能直接识别。示例配置如下：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <!-- 替换成你的WordCount类全限定名，比如com.example.WordCount -->
                        <mainClass>WordCount</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 构建包含依赖的"胖JAR"（推荐） #

如果你的项目依赖了第三方库，或者集群环境缺少某些依赖，建议用maven-shade-plugin打包一个包含所有依赖的可执行JAR，避免运行时出现依赖类找不到的问题。示例配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>WordCount</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置完成后执行mvn clean package，生成的shaded JAR就是可以直接在Hadoop上运行的完整包。

3. 检查运行命令是否正确 #

• 如果已经在pom中指定了主类，运行命令可以简化为：

  hadoop jar your-jar-file.jar /input-path /output-path
  

• 如果没指定主类，需要在命令里明确给出主类的全限定名：

  hadoop jar your-jar-file.jar com.example.WordCount /input-path /output-path
  

  这里要注意：类名必须和JAR内的实际路径一致，你可以用jar tf your-jar-file.jar命令查看JAR的文件结构，确认WordCount.class的完整路径。

4. 验证JAR内是否包含主类文件 #

执行jar tf your-jar-file.jar，看看输出里有没有WordCount.class（如果有包名，路径应该是包名/WordCount.class）。要是找不到这个文件，说明Maven打包时没正确编译或包含你的主类，得检查项目目录结构是否符合Maven规范（比如主类要放在src/main/java目录下）。

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