Maven构建报错：未找到assembly描述符，请求协助排查

你的报错Error reading assemblies: No assembly descriptors found和Java版本、JAVA_HOME无关，根源是Maven装配插件（maven-assembly-plugin）找不到配置描述文件，或者你误执行了需要该插件的命令。

核心原因 #

你当前的pom.xml只配置了编译插件，没有配置maven-assembly-plugin，但你可能执行了mvn assembly:single这类需要装配插件的命令，导致Maven找不到对应的装配规则文件。

解决步骤 #

场景1：只需要生成普通可运行Jar包 #

如果只是想编译代码并生成基础Jar包，直接执行以下命令即可：

mvn clean package

执行完成后，Jar包会生成在项目根目录的target文件夹下，命名格式为simple-java21-maven-1.0.0.jar。

场景2：需要自定义装配（比如打包依赖、合并资源） #

如果确实需要自定义打包规则，需要添加maven-assembly-plugin配置并创建装配描述文件：

1. 在pom.xml的<build><plugins>中添加以下插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.6.0</version>
    <configuration>
        <!-- 指定装配描述文件路径 -->
        <descriptor>src/main/assembly/assembly.xml</descriptor>
        <!-- 设置生成的可执行Jar入口类（根据你的HelloWorld类路径修改） -->
        <archive>
            <manifest>
                <mainClass>com.example.HelloWorld</mainClass>
            </manifest>
        </archive>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 在项目的src/main/assembly目录下创建assembly.xml文件（目录不存在则手动创建），示例内容如下（可按需调整）：

<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.1.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.1.0 http://maven.apache.org/xsd/assembly-2.1.0.xsd">
    <id>jar-with-dependencies</id>
    <formats>
        <format>jar</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <dependencySets>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>runtime</scope>
        </dependencySet>
    </dependencySets>
</assembly>

3. 执行命令生成自定义Jar：

mvn clean package

生成的Jar包会包含所有依赖，命名格式为simple-java21-maven-1.0.0-jar-with-dependencies.jar。

额外验证 #

确认Maven使用的Java版本：执行mvn -v，检查输出中的Java version是否为21，确保Maven确实调用了正确的JDK。

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