Troubleshooting
What to do when you have problems running an analysis in SonarQube for Eclipse.
Knowing where to begin looking for information is the first step to reaching out for help. Many answers to commonly found problems can be found on the SonarQube for IDE channel of the Sonar community forum. See below for the basic steps to access the SonarQube for IDE logs when the analysis results are not what you expected.
Before posting to the Sonar community, make sure that you have your logs ready by following the instructions below.
How to get SonarQube for Eclipse logs
Open the Eclipse Console view.
Open the SonarQube Console.
Behind the double-gear dropdown menu in the Console view, enable Verbose output.
Reproduce the issue; for example, reopen the offending file.

IDE-specific traces are useful when troubleshooting only when Eclipse-specific activity is related to SonarQube for Eclipse errors.
How to get the Eclipse logs
Sometimes errors are not in the SonarQube for Eclipse console but could be directly in Eclipse error logs.
Open Eclipse Error Log view: go to Eclipse > Window > Show view > Other… > General and select Error Log from the list
Look for an error event related to SonarQube for Eclipse
Open event details to get the stacktrace
How to get SonarQube for Eclipse thread dumps
In some cases, it can be useful to extract thread dumps from the running instance of your IDE for debugging; thread dumps can help us investigate UI freeze issues or threading problems.
If SonarQube for IDE does not start or stops working and the IDE is still running, thread dumps are necessary to properly troubleshoot the problem before the IDE is restarted. If you restart the IDE, some information about what was happening when it failed will be lost. Fortunately, thread dumps are easy to obtain for both SonarQube for IDE and your IDE.
Once obtained, please report your error to the Sonar community forum. Your thread dump may contain sensitive details and if it’s required for further troubleshooting, it will be possible to share your thread dump privately.
Getting an IDE thread dump
You must first get the process ID for your IDE, then export the thread dump. The jps
and jstack
commands below are utilities that come bundled with the Java JDK.
While SonarQube for Eclipse is running, run
jps
in your terminal to see a list of process IDs (PID).Note the PID of
Eclipse
.Run
jstack -F -l <
PROCESS_ID
> > eclipse_thread_dump.txt
to get the thread dump.
Getting a SonarQube for Eclipse thread dump
Getting the process ID for SonarQube for Eclipse is the same as for the IDE; simply note the ID for SonarLintServerCli
or run the command again, then export the thread dump. The jps
and jstack
commands below are utilities that come bundled with the Java JDK.
While SonarQube for Eclipse is running, run
jps
in your terminal to see a list of process IDs (PID).Note the PID of
SonarLintServerCli
.Run
jstack -F -l <
PROCESS_ID
> > sonarqube-for-eclipse_thread-dump.txt
to get the thread dump.
Troubleshooting connected mode setup
No matching project found
No matching project is found because:
It’s best if you already have the project open in your IDE, otherwise SonarQube for Eclipse might not be able to find a matching file.
SonarQube for Eclipse can get confused if you have multiple projects open in the workspace. Please open or choose the correct project and try again.
If these solutions don’t help, follow the instructions for Project binding to manually configure your project binding.
No matching issue found
SonarQube for Eclipse can’t find your issue because:
You might not be on the same branch.
The issue was fixed, or the source code may be different from the analyzed version.
Troubleshooting unexpected analysis results
Sometimes, issues found on the server differ from those found locally by SonarQube for IDE. Usually, the server-side rule configuration (your quality profile) is to blame; however, it could be something more than that. Maybe your local build configuration and system dependencies don’t align with your DevOps pipeline, or it could simply be that the issue, due to its complexity, is only detectable by SonarQube Server or SonarQube Cloud.
The collapsible below lists some of the most commonly encountered reasons, along with some details that will help you troubleshoot discrepancies.
FAQ
Are my SonarScanner properties applied to SonarQube for Eclipse?
No. Scanner properties you may have defined in the sonar-project.properties
or pom.xml
files (for example sonar.sources
or sonar.projectBasedir
) only make sense when modifying the SonarScanner in the command line. SonarQube for Eclipse tries to use IDE metadata to avoid other configurations.
If you want to share some configuration between SonarScanners and SonarQube for Eclipse, like File exclusions, or some specific analyzer properties (see Scan my project), the best way is to use Connected mode and set the configuration in the SonarQube (Server, Cloud) or SonarQube Community Build UI.
Last updated
Was this helpful?