OSV 与 SCA 扫描器
查找依赖中的已知 CVE,优先显示已被利用的漏洞,并提供经过验证、适配 Spring Boot 的修复方案。
本页内容 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…) |
| 生态系统 | 读取的文件 |
|---|---|
| npm | package-lock.、yarn.(v1 和 Berry)、pnpm-lock.、bun.、package. |
| PyPI | poetry.、uv.、pdm.、Pipfile.、conda-lock.、requirements*.、pyproject.、Pipfile、environment. |
| Maven / Gradle | pom.、build.、gradle.、版本目录 |
| Go | go.(含 replace) |
| crates.io | Cargo.、Cargo. |
| RubyGems | Gemfile.、Gemfile |
| NuGet | packages.、obj/、.(含集中式包版本)、packages. |
| Packagist | composer.、composer. |
| Pub | pubspec.、pubspec. |
| Hex | mix. |
| SwiftPM | Package.、Package. |
| CRAN | renv. |
不支持的格式(sbt、CocoaPods、Conan、vcpkg、Bazel 等)的文件会按名称列出,并且扫描会被标记为不完整。
- 完整依赖树。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 始终明确区分,没有发现问题的不完整扫描绝不会显示为安全。
- 已知被利用:CISA 已知被利用漏洞目录中的 CVE 会被标记为 Exploited 并排在最前面,同时显示 CISA 要求的处置措施以及是否被用于勒索软件。
- 依赖健康度:已弃用、已撤回、无人维护或不活跃的包属于维护风险;过时的包仅作提示。绝不会仅因为包比较旧就判定其存在漏洞。
- 项目:列出 Maven Reactor、Gradle 构建以及 npm、Yarn、pnpm 或 Bun 工作区及其 Spring Boot 版本。可以全部扫描,也可以勾选想要扫描的项目。
- 标签页:Vulnerabilities、Remediation、Dependency health、Dependencies,以及显示每个公告来源的状态和各阶段耗时的 Sources & notes。
SCA Scanner 会记录每个托管版本的来源——你的 POM、spring-boot-starter-parent、Boot 导入的 BOM 或你自己导入的 BOM——并在正确的位置提出修复,按安全程度从高到低排列:
- 升级 Spring Boot 到其 BOM 管理了修复版本的最低版本:先补丁版本,再次要版本,最后主要版本(对 Boot 3 会附上关于 Java 17 和
jakarta.的提示)。* - 覆盖 Boot 属性(
tomcat.、version snakeyaml.)或嵌套 BOM 的属性(version spring-framework.),让同一系列的库一起升级。version - 当版本由导入的 BOM 设置时,在你自己的
<dependencyManagement>中固定版本。在 Gradle 中:升级 Boot 插件或设置ext['…']。
示例:覆盖 Boot 属性
当 Tomcat 受影响、而升级到更新的 Boot 版本跨度太大时,扫描器可以建议修改 Spring Boot BOM 读取的属性:
<properties>
<tomcat.version>10.1.35</tomcat.version>
</properties>Boot 管理的所有 Tomcat 构件都会一起升级到该版本。
直接依赖会在 pom.、build.、package.、requirements.、.、composer. 或 Cargo. 中修改版本;npm 的传递依赖会使用 overrides、resolutions 或 pnpm.。
任何内容都不会自动更改。Preview Change 会打开 diff,Apply… 或 Run… 会先征求确认。修改会保留你的格式和版本范围运算符,绝不会编辑锁文件,也不会安装或构建任何内容。在不受信任的工作区中禁止修改。
| 服务 | 接收的内容 |
|---|---|
| OSV.dev | 包名和版本 |
| 包注册表(SCA 健康检查) | 包名 |
| NVD(SCA) | CVE 编号 |
| Maven Central | POM 和 BOM 坐标 |
| CISA(SCA) | 无:下载的是公开目录 |
绝不会发送源代码、文件内容、路径、项目名称或凭据。
扫描器报告的是受影响的版本;它们不会检查你的代码是否真的调用了存在漏洞的函数。只会报告扫描时已在 OSV 中发布的安全公告。请提交你的锁文件:没有锁文件时,发现结果只能是 Potential。