如何在withCredentials中获取用户范围凭证？遇CredentialNotFoundException错误

我来帮你搞定这个报错——你遇到的org.jenkinsci.plugins.credentialsbinding.impl.CredentialNotFoundException，核心原因是你的Jenkins构建任务没有被授权访问用户私有的凭证，哪怕你通过参数让用户选了凭证ID，任务本身没权限读取这些个人范围的凭证。下面是分步解决方法：

1. 确保任务有权限访问用户凭证 #

首先要让你的Jenkins构建任务能够读取用户私有的凭证：

• 打开任务的配置页面，找到权限控制相关的设置（如果你的Jenkins用的是「项目矩阵授权策略」，或者装了「Role-based Authorization Strategy」插件）
• 给执行构建的用户（或者任务本身的权限主体）添加Credentials权限组里的View权限，并且要指定权限作用范围是「用户私有凭证」
• 另外，也可以直接在用户的凭证配置页面（右上角用户头像 → Credentials → 找到对应凭证点击配置），在「授权的项目」里把你的构建任务添加进去，这样这个凭证就只允许该任务访问

2. 正确配置参数化构建的凭证下拉列表 #

不要用普通的字符串参数，一定要用专门的凭证参数类型：

• 先确保你的Jenkins安装了Credentials Parameter插件（没装的话去「插件管理」里搜索安装）
• 在任务配置的「参数化构建过程」里，添加一个「Credentials Parameter」：
  • 参数名设为customUser（和你Pipeline里的params.customUser对应）
  • 「Credential type」选择你需要的类型（比如「Username with password」，和你withCredentials里的usernamePassword对应）
  • 关键设置：在「Credentials scope」里选择User，这样下拉列表只会显示当前触发构建的用户自己的私有凭证，不会混入全局凭证

3. Pipeline代码的注意事项 #

你的现有代码本身是没问题的，但要注意两个点：

withCredentials([usernamePassword(credentialsId: params.customUser, usernameVariable: 'USERNAME', passwordVariable: 'PASSWORD')]) {
    // 这里使用USERNAME和PASSWORD的逻辑
}

• 确保触发构建的用户是该凭证的所有者，或者该用户被授权访问该凭证
• 如果是用Jenkinsfile的流水线，要确保流水线的执行上下文是触发用户的权限（默认情况下，用户手动触发的构建会用自己的权限，这点一般没问题）

4. 排查验证步骤 #

如果还是报错，可以按这些步骤排查：

• 让用户自己去「个人凭证」页面确认凭证ID和参数里选择的完全一致（有时候会有大小写或者空格的问题）
• 用该用户账号手动触发构建，不要用管理员账号测试，避免权限混淆
• 查看Jenkins的系统日志（Manage Jenkins → System Log），里面可能会有更详细的权限拒绝信息，有时候CredentialNotFoundException其实是权限不足导致的，而非凭证不存在

内容的提问来源于stack exchange，提问作者Chris Jaga