OSV 与 SCA 扫描器

查找依赖中的已知 CVE,优先显示已被利用的漏洞,并提供经过验证、适配 Spring Boot 的修复方案。

阅读约 5 分钟
本页内容 7 个小节

两个扫描器共用一个引擎,因此对每个依赖和安全公告的结论始终一致。它们会读取你的锁文件、清单以及 Maven 或 Gradle 构建,并对照 OSV.dev 检查每个解析出的包版本。OSV.dev 涵盖 GitHub Advisory Database、PyPA、Go、RustSec 等。无需账号、API 密钥或命令行工具。

扫描器用途
OSV Vulnerability Scanner查找所有依赖中的已知 CVE 和 GHSA 安全公告,并给出修复版本和适用于你的包管理器的升级命令。可导出 HTML 或 JSON 报告。
SCA Scanner包含以上所有功能,另外优先显示 CISA 已知被利用的 CVE、在 OSV 缺失时补充来自 NVD 的 CVSS、依赖健康度、项目选择,以及可通过 diff 预览的适配 Spring Boot 的修复。可导出 JSON 或 CSV。

运行扫描

要……这样做
打开 OSV 面板工具侧边栏 → Security & Auth → OSV Vulnerability Scanner,或运行 DevSnip Pro: OSV Vulnerability Scanner
直接扫描工作区运行 DevSnip Pro: Scan Workspace Dependencies for Vulnerabilities (OSV)
扫描单个锁文件、清单或项目文件夹在资源管理器中右键点击它 → Scan for Vulnerabilities (OSV)
不打开文件夹而扫描文件在 OSV 面板中使用 Scan Files…
打开 SCA Scanner工具侧边栏 → Security & Auth → SCA Scanner,或运行 DevSnip Pro: SCA Scanner
直接用 SCA Scanner 扫描运行 DevSnip Pro: Scan Dependencies (SCA…)

支持的生态系统

生态系统读取的文件
npmpackage-lock.json、yarn.lock(v1 和 Berry)、pnpm-lock.yaml、bun.lock、package.json
PyPIpoetry.lock、uv.lock、pdm.lock、Pipfile.lock、conda-lock.yml、requirements*.txt、pyproject.toml、Pipfile、environment.yml
Maven / Gradlepom.xml、build.gradle(.kts)、gradle.lockfile、版本目录
Gogo.mod(含 replace)
crates.ioCargo.lock、Cargo.toml
RubyGemsGemfile.lock、Gemfile
NuGetpackages.lock.json、obj/project.assets.json、.csproj(含集中式包版本)、packages.config
Packagistcomposer.lock、composer.json
Pubpubspec.lock、pubspec.yaml
Hexmix.lock
SwiftPMPackage.resolved、Package.swift
CRANrenv.lock

不支持的格式(sbt、CocoaPods、Conan、vcpkg、Bazel 等)的文件会按名称列出,并且扫描会被标记为不完整。

Spring Boot、Maven 与 Gradle

  • 完整依赖树。Starter、Parent 和 BOM 引入的库(Tomcat、Spring Framework、Jackson、SnakeYAML、Logback……)也会被检查。
  • Maven 或 Gradle 本身会在你对每个受信任工作区授权一次后解析依赖树。它们以只读方式运行:不会编译、安装或修改任何内容。
  • 否则,内置解析器会遵循 Maven 的规则(Parent、BOM 导入、属性、就近优先、排除、版本范围),Gradle 构建脚本读取器能够理解 Spring Boot 插件、mavenBom、platform、版本目录以及 extra["tomcat.version"] 这类覆盖写法。
  • 多模块 Reactor 和多项目构建会作为一个整体构建进行解析。你自己的模块永远不会被当作包去查询。

结果如何判定

  • Confirmed:锁文件或精确固定的版本给出了实际安装的版本。
  • Potential:只知道版本范围,而安全公告可能影响该范围。
  • Not analysed:版本未知、查询失败,或来源不在 OSV 范围内(git、本地路径、私有注册表),并附上原因。
  • 严重程度来自安全公告:优先使用 GitHub 审核过的评级,其次是 CVSS 评分。SCA Scanner 会用 NVD 补全缺失的评分并注明来源。绝不会凭空编造评分。
  • Scan complete 和 Scan incomplete 始终明确区分,没有发现问题的不完整扫描绝不会显示为安全。

SCA Scanner 额外提供的功能

  • 已知被利用:CISA 已知被利用漏洞目录中的 CVE 会被标记为 Exploited 并排在最前面,同时显示 CISA 要求的处置措施以及是否被用于勒索软件。
  • 依赖健康度:已弃用、已撤回、无人维护或不活跃的包属于维护风险;过时的包仅作提示。绝不会仅因为包比较旧就判定其存在漏洞。
  • 项目:列出 Maven Reactor、Gradle 构建以及 npm、Yarn、pnpm 或 Bun 工作区及其 Spring Boot 版本。可以全部扫描,也可以勾选想要扫描的项目。
  • 标签页:Vulnerabilities、Remediation、Dependency health、Dependencies,以及显示每个公告来源的状态和各阶段耗时的 Sources & notes。

适配 Spring Boot 的修复

SCA Scanner 会记录每个托管版本的来源——你的 POM、spring-boot-starter-parent、Boot 导入的 BOM 或你自己导入的 BOM——并在正确的位置提出修复,按安全程度从高到低排列:

  1. 升级 Spring Boot 到其 BOM 管理了修复版本的最低版本:先补丁版本,再次要版本,最后主要版本(对 Boot 3 会附上关于 Java 17 和 jakarta.* 的提示)。
  2. 覆盖 Boot 属性(tomcat.version、snakeyaml.version)或嵌套 BOM 的属性(spring-framework.version),让同一系列的库一起升级。
  3. 当版本由导入的 BOM 设置时,在你自己的 <dependencyManagement> 中固定版本。在 Gradle 中:升级 Boot 插件或设置 ext['…']。
示例:覆盖 Boot 属性

当 Tomcat 受影响、而升级到更新的 Boot 版本跨度太大时,扫描器可以建议修改 Spring Boot BOM 读取的属性:

pom.xml
<properties>
  <tomcat.version>10.1.35</tomcat.version>
</properties>

Boot 管理的所有 Tomcat 构件都会一起升级到该版本。

直接依赖会在 pom.xml、build.gradle、package.json、requirements.txt、.csproj、composer.json 或 Cargo.toml 中修改版本;npm 的传递依赖会使用 overrides、resolutions 或 pnpm.overrides。

提示

任何内容都不会自动更改。Preview Change 会打开 diff,Apply… 或 Run… 会先征求确认。修改会保留你的格式和版本范围运算符,绝不会编辑锁文件,也不会安装或构建任何内容。在不受信任的工作区中禁止修改。

隐私

服务接收的内容
OSV.dev包名和版本
包注册表(SCA 健康检查)包名
NVD(SCA)CVE 编号
Maven CentralPOM 和 BOM 坐标
CISA(SCA)无:下载的是公开目录

绝不会发送源代码、文件内容、路径、项目名称或凭据。

请注意

扫描器报告的是受影响的版本;它们不会检查你的代码是否真的调用了存在漏洞的函数。只会报告扫描时已在 OSV 中发布的安全公告。请提交你的锁文件:没有锁文件时,发现结果只能是 Potential。