Skip to main content
Documents
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Jenkins 凭据错误

Jenkins 创建凭据后在 Credentials 列表中不可见、无法选择,通常是因为凭据作用域 (Scope) 设置错误、凭据类型与使用场景不匹配、插件缺失(如 Git Plugin)或 Jenkins 缓存/权限问题。需检查凭据的 Domain (域) 是否正确,并确认其对当前项目的可见性。

常见原因及排查步骤

凭据作用域 (Scope) 不正确(最常见)

凭据可能被限制在某个特定的 Folder 或 Item 内,而不是全局 (Global)。检查创建凭据时的 Scope 设置。

凭据类型不匹配

例如,Git SCM 需要的是 Username with password 或 SSH Username with private key 类型凭据。如果创建了 Secret text,在 Git 配置中就无法选择。

Jenkins 插件问题

确保安装了必需的插件(如 Git plugin, Credentials Binding Plugin 等)。某些凭据类型(如 SSH)依赖特定插件。

Jenkins 缓存/UI 问题

尝试刷新页面、清除浏览器缓存,或重启 Jenkins 服务。

权限/RBAC (基于角色的访问控制) 问题

当前登录用户可能没有查看该凭据的权限(特别是对于限制了访问权限的凭据)。

域 (Domain) 设置问题

检查凭据是否被添加到了错误的 Domain (例如,某些特定插件会创建自己的域)。

解决流程

  1. 进入 Dashboard > Credentials > System > Global credentials (unrestricted) 或对应的 Domain 查看。

  2. 新建凭据时,注意选择正确的 Kind (类型) 和 Scope (作用域,通常选 Global 以便全局使用)。

  3. 在具体的 Job 配置中(如 Git 源码管理),确保凭据列表显示范围符合预期。