使用Maven执行SonarQube扫描失败，提示未知生命周期阶段错误

问题描述 #

我跟着《SonarQube-Spring Boot》教程学习SonarQube，但执行扫描时失败。已在SonarQube中生成令牌，在IntelliJ中执行命令：

mvn sonar:sonar -Dsonar.login=sqp_e1cf0bc2bf1ea3567f35f4667c2edd2ca37b4c78

报错提示：未知生命周期阶段“.login=”。我的POM文件插件配置如下：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.sonarsource.scanner.maven</groupId>
            <artifactId>sonar-maven-plugin</artifactId>
            <version>3.9.1.2184</version>
        </plugin>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.5</version>
            <executions>
                <execution>
                    <id>prepare-agent</id>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                </execution>
                <execution>
                    <id>report</id>
                    <goals>
                        <goal>report</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

问题原因 #

这个错误是因为Maven错误地将.login=识别成了一个生命周期阶段，本质是命令行参数解析失败，常见触发原因：

• 复制命令时带入了不可见的特殊字符（如多余空格、换行符）
• 终端输入时不小心拆分了参数，导致-Dsonar和.login=...被当成独立命令段

解决方案 #

方案1：手动重新输入命令 #

不要直接复制粘贴，手动输入完整命令，确保参数连续无多余符号：

mvn sonar:sonar -Dsonar.login=sqp_e1cf0bc2bf1ea3567f35f4667c2edd2ca37b4c78

方案2：将配置写入POM文件（更稳定） #

把SonarQube令牌配置到sonar-maven-plugin中，彻底避免命令行参数出错：
修改POM中的Sonar插件配置：

<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.9.1.2184</version>
    <configuration>
        <sonar.login>sqp_e1cf0bc2bf1ea3567f35f4667c2edd2ca37b4c78</sonar.login>
    </configuration>
</plugin>

之后直接执行简化命令即可：

mvn sonar:sonar

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