spring-boot-maven-plugin报红解决方案(亲测有效)

关于“spring-boot-maven-plugin报红解决方案(亲测有效)”的完整攻略，我将分步骤进行讲解，包括解决方案和示例代码。

问题描述

在使用Spring Boot项目时，我们通常会使用官方提供的spring-boot-maven-plugin插件来构建和打包项目，在使用该插件时，可能出现如下错误提示：

Plugin execution not covered by lifecycle configuration: org.springframework.boot:spring-boot-maven-plugin:[插件版本], requires a coverage matching configuration or explicitly declaring a lifecycle phase.

这个错误提示的意思是，在Maven中没有为spring-boot-maven-plugin插件声明生命周期，因此Maven无法识别该插件的生命周期并执行相关操作，导致插件报红无法正确执行。

解决方案

要解决这个问题，我们可以借助Maven的lifecycleMappingMetadata来显式地声明这个插件的生命周期。

具体步骤如下：

1. 在项目的根目录下新建lifecycle-mapping-metadata.xml文件，用于声明插件生命周期映射关系。该文件内容如下所示：

<lifecycleMappingMetadata>
    <pluginExecutions>
        <pluginExecution>
            <pluginExecutionFilter>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <versionRange>[插件版本]</versionRange>
                <goals>
                    <goal>repackage</goal>
                </goals>
            </pluginExecutionFilter>
            <action>
                <execute />
            </action>
        </pluginExecution>
    </pluginExecutions>
</lifecycleMappingMetadata>

其中，<versionRange>节点填写spring-boot-maven-plugin插件的版本号，<goal>节点填写repackage，表示重新打包。

1. 在项目的pom.xml文件中，添加如下代码：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-plugin-plugin</artifactId>
            <version>3.6.1</version>
            <executions>
                <execution>
                    <id>default-descriptor</id>
                    <goals>
                        <goal>descriptor</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

这里是使用maven-plugin-plugin插件生成lifecycle-mapping-metadata.xml文件，确保其经过generate-resources生命周期阶段。

示例代码

这里我们提供两个示例代码，一个是Java工程，另一个是Kotlin工程。

Java工程

在Java工程的pom.xml文件中，添加如下代码：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.5.6</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <!-- Add this code -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-plugin-plugin</artifactId>
            <version>3.6.1</version>
            <executions>
                <execution>
                    <id>default-descriptor</id>
                    <goals>
                        <goal>descriptor</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

然后在项目的根目录下新建lifecycle-mapping-metadata.xml文件，并添加以下内容：

<lifecycleMappingMetadata>
    <pluginExecutions>
        <pluginExecution>
            <pluginExecutionFilter>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <versionRange>[2.5.6,)</versionRange>
                <goals>
                    <goal>repackage</goal>
                </goals>
            </pluginExecutionFilter>
            <action>
                <execute />
            </action>
        </pluginExecution>
    </pluginExecutions>
</lifecycleMappingMetadata>

这样就完成了Java工程的spring-boot-maven-plugin报红解决方案。

Kotlin工程

在Kotlin工程的pom.xml文件中，添加如下代码：

<build>
    <plugins>
        <plugin>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-plugin</artifactId>
            <version>${kotlin.version}</version>
            <executions>
                <execution>
                    <id>kotlin-compile</id>
                    <goals> <goal>compile</goal> </goals>
                </execution>
                <execution>
                    <id>kotlin-test-compile</id>
                    <goals> <goal>test-compile</goal> </goals>
                </execution>
            </executions>
        </plugin>

        <!-- spring-boot-maven-plugin -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.5.6</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

        <!-- Add this code -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-plugin-plugin</artifactId>
            <version>3.6.1</version>
            <executions>
                <execution>
                    <id>default-descriptor</id>
                    <goals>
                        <goal>descriptor</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>

</build>

然后在项目的根目录下新建lifecycle-mapping-metadata.xml文件，并添加以下内容：

<lifecycleMappingMetadata>
    <pluginExecutions>
        <pluginExecution>
            <pluginExecutionFilter>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <versionRange>[2.5.6,)</versionRange>
                <goals>
                    <goal>repackage</goal>
                </goals>
            </pluginExecutionFilter>
            <action>
                <execute />
            </action>
        </pluginExecution>
    </pluginExecutions>
</lifecycleMappingMetadata>

这样就完成了Kotlin工程的spring-boot-maven-plugin报红解决方案。

总结

通过以上步骤，我们可以顺利解决spring-boot-maven-plugin报红的问题，使构建和打包工作更加顺畅。