使用Gradle向SonarQube传递手动属性时遇任务未找到问题

问题场景 #

在Windows系统下使用Gradle集成SonarQube时，尝试通过命令行传递Sonar登录参数失败：
执行命令：

gradle sonar -Dsonar.login=admin -Dsonar.password=admin

触发错误：

Task '.login=admin' not found in root project 'gradle_test'.

但将Sonar配置写入gradle.properties文件可正常运行：

systemProp.sonar.host.url=http://localhost:9000
systemProp.sonar.login=admin
systemProp.sonar.password=admin

当前使用的Gradle插件配置：

plugins {
    id 'java'
    id "org.sonarqube" version "4.3.0.3225"
}

问题原因 #

Windows命令行（CMD/PowerShell）对Gradle参数的解析逻辑与Linux/macOS不同：所有-D开头的系统属性参数必须放在任务名称（如sonar）之前，否则会被识别为任务的一部分，导致Gradle找不到对应任务。

解决方法 #

方法1：调整参数位置（推荐） #

将-D参数移到gradle命令和sonar任务之间：

gradle -Dsonar.login=admin -Dsonar.password=admin sonar

如果需要指定Sonar服务器地址，同样把参数放在任务前：

gradle -Dsonar.host.url=http://localhost:9000 -Dsonar.login=admin -Dsonar.password=admin sonar

方法2：使用--args传递参数（适用于PowerShell） #

如果在PowerShell中执行，也可以通过--args将参数传递给Gradle任务：

gradle sonar --args="-Dsonar.login=admin -Dsonar.password=admin"

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