Jenkins流水线中Lightweight checkout不被支持的原因是什么？

问题相关报错输出：

Lightweight checkout support not available, falling back to full checkout.

核心疑问：该问题是否由Jenkinsfile未存放在项目根目录导致？

该问题和Jenkinsfile是否存放在项目根目录没有直接关系。

Lightweight checkout（轻量级检出）的实现逻辑是Jenkins Git插件直接调用对应Git托管平台的API拉取指定路径的Jenkinsfile，不需要克隆整个仓库，触发回退到全量检出的常见原因如下：

• 配置的仓库凭证仅拥有仓库克隆权限，没有Git托管平台的API读取权限，插件无法调用接口拉取单个文件
• 你使用的Git托管服务不在Jenkins Git插件的适配范围内，目前该功能仅支持主流的公有Git托管平台以及常见的开源自建Git服务（如GitLab、GitHub、Gitea等）
• 你配置的流水线引用的分支、Tag、Commit ID不存在，或者指定的Jenkinsfile路径在对应版本中不存在，插件拉取文件失败后会自动回退
• 流水线配置中同时启用了和轻量级检出冲突的参数，比如自定义克隆规则、子模块拉取配置等，也会导致轻量级检出不可用

Git版本本身不会影响该功能的可用性，即使触发回退也不会影响流水线的正常执行，仅会增加代码拉取环节的耗时。

内容的提问来源于stack exchange，提问作者Lieven Cardoen