运行sonar-runner.bat构建Java项目时提示需提供编译类，构建失败

这是SonarQube分析Java项目时非常常见的问题——它需要访问你项目编译后的class文件才能完成代码质量检测，而你当前的配置里没告诉它这些文件在哪。下面是几种实用的解决方法：

方法1：命令行直接指定参数 #

运行sonar-runner.bat的时候，直接通过-D参数传入编译类的路径：

sonar-runner.bat -Dsonar.java.binaries=target/classes

• 如果你用的是Maven，默认编译后的class文件在target/classes目录；
• 如果你用的是Gradle，路径通常是build/classes/java/main；
• 要是你自定义了编译输出目录，替换成你项目实际的路径就行（相对路径是相对于你运行命令的项目根目录，绝对路径也可以）。

方法2：配置sonar-project.properties文件 #

在你的项目根目录下（如果没有就新建一个）创建sonar-project.properties文件，添加以下配置：

# 项目基础配置
sonar.projectKey=my-java-project
sonar.projectName=我的Java项目
sonar.projectVersion=1.0

# 源代码目录
sonar.sources=src/main/java

# 关键：指定编译后的类文件路径
sonar.java.binaries=target/classes

保存后再运行sonar-runner.bat就会自动读取这个配置，不用每次都在命令行输参数。

方法3：用构建工具集成（更推荐） #

其实没必要单独用sonar-runner，直接用Maven或Gradle的Sonar插件更省心，它们会自动识别编译目录，不用手动配置sonar.java.binaries：

• Maven项目：直接运行

  mvn sonar:sonar
  

• Gradle项目：先在build.gradle里配置Sonar插件，然后运行

  gradle sonar
  

额外注意事项 #

• 如果是多模块项目，每个模块可能需要单独指定对应的sonar.java.binaries路径；
• 要是项目有外部依赖的jar包需要分析，还可以加上sonar.java.libraries=lib/*.jar这样的参数指定依赖路径。

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