VS Code中SonarLint无法连接SonarQube服务器问题

云上老周

2026-8-5

SonarLint连接SonarQube更新绑定失败问题处理

问题详情

在VS Code中使用SonarLint插件连接SonarQube服务器，执行更新绑定时，输出面板报错找不到指定存储文件：

Failed to read file: /home/valentina/.sonarlint/storage/38364531464134442d41594f79334277794d7331626178675137786850/projects/486f7473706f74/project_branches.pb
...
Caused by: org.sonarsource.sonarlint.core.serverconnection.storage.StorageException: Failed to read file: /home/valentina/.sonarlint/storage/38364531464134442d41594f79334277794d7331626178675137786850/projects/486f7473706f74/project_branches.pb
...
Caused by: java.nio.file.NoSuchFileException: /home/valentina/.sonarlint/storage/38364531464134442d41594f79334277794d7331626178675137786850/projects/486f7473706f74/project_branches.pb
...

当前SonarLint配置文件如下：

{
    "sonarlint.connectedMode.connections.sonarqube": [
        {
            "serverUrl": "http://localhost:9000",
            "connectionId": "86E1FA4D-AYOy3BwyMs1baxgQ7xhP",
            "token": "squ_5e74e1ff17a56c1ae026df4663503bd1369f9966"
        }
    ],
    "sonarlint.connectedMode.project": {
    "connectionId": "86E1FA4D-AYOy3BwyMs1baxgQ7xhP",
    "projectKey": "Hotspot"
    }
}

解决步骤

清空本地存储缓存
删除报错路径对应的存储目录：/home/valentina/.sonarlint/storage/38364531464134442d41594f79334277794d7331626178675137786850，或者直接删除整个~/.sonarlint/storage文件夹，彻底清除本地缓存数据。
重启VS Code并重新绑定
关闭VS Code后重新打开，在SonarLint面板中再次执行更新绑定操作，让插件重新从SonarQube服务器拉取完整的项目数据，自动生成所需的存储文件。
核对配置信息
确认配置文件里的projectKey和SonarQube服务器上的项目Key完全匹配；检查token是否有效；确保SonarQube服务器正常运行。
检查目录权限
确认当前用户对/home/valentina/.sonarlint目录拥有读写权限，避免因权限不足导致插件无法生成或读取存储文件。