故障排除
先查看管道日志。该步骤会指明扫描器或错误。
| 现象 | 原因和解决方法 |
|---|---|
| 步骤失败并指明某个扫描器 | 该扫描器不在 PATH 中、崩溃、以错误退出或没有写出可用的 SARIF。在代理上安装它并重新运行。 |
| 接入返回 401 | 接入令牌缺失、错误或已被撤销。在 Pipeline 页面生成一个新的。 |
| 接入返回 415 | 请发送 Content-Type: application/json。 |
接入返回 400 empty_sarif 或 invalid_sarif | 请求体中没有 SARIF，或文档没有指明其工具。请检查扫描器输出。 |
| 接入返回 409 | 关卡阻止了这次运行。打开 Findings，修复或例外处理达到或高于你的阈值的发现。 |
| 拉取请求上没有评论 | Azure DevOps：添加 SYSTEM_ACCESSTOKEN env 这一行，给予构建服务“参与拉取请求”（Contribute to pull requests）权限，并在拉取请求上运行管道。GitHub：给作业设置 pull-requests: write，并在分支上运行，而不是在 fork 上。 |
更改被拒绝，提示 insufficient_role | 只有工作区所有者和管理员可以更改关卡、令牌、Azure DevOps 共享和例外。 |
| Pipeline 页面上没有 Marketplace 链接 | 扩展在你保存组织后手动共享。在此之前，请使用首次扫描示例或 GitHub Action。 |
| Findings 下没有任何内容 | 从 Pipeline 页面发送首次扫描示例，然后检查 Findings 上的状态筛选。 |
如有其他问题，请写信到 hello@spot-suite.com，并附上工作区地址和管道日志。