Jenkins Klocwork 2020.3插件执行构建任务时认证失败问题咨询

问题排查与解决步骤 #

• 优先检查插件内置凭证配置
  2020.3版本的Klocwork Analysis插件调整了认证优先级，默认优先读取插件全局配置内的绑定凭证，而非ltoken文件或环境变量。

  1. 进入Jenkins「Manage Jenkins」→「Global Tool Configuration」/「Configure System」，找到Klocwork服务器配置区块
  2. 添加你的Klocwork服务URL，在凭证栏选择对应账户的认证信息（支持直接填写ltoken内容或者用户名密码），保存配置
  3. 回到出问题的作业配置页，在Klocwork分析步骤的「Klocwork Server」选项中，选择你刚才配置好的服务器实例，不要留空使用默认值

• 验证ltoken文件访问权限
  即使插件日志显示识别到ltoken路径，也可能存在Jenkins服务账户无文件读取权限的问题：

  1. 右键C:\Users\<my-USER>\.klocwork\ltoken文件，打开「安全」选项卡
  2. 确认Jenkins服务的运行账户（可在Windows服务管理器里查看Jenkins服务的「登录身份」）已被赋予该文件的读取权限
  3. 也可将ltoken文件移动到公共可读目录（例如C:\klocwork_config\ltoken），再在插件配置中修改为新路径测试

• 确认运行环境一致性
  在出错的Jenkins作业中添加前置的Windows批处理步骤，执行以下命令排查环境问题：

  :: 检查Klocwork相关环境变量是否正确传递
  set KLOCWORK
  :: 确认插件调用的Klocwork客户端路径是否和你手动执行的一致
  where kwbuildproject
  

  如果输出的KLOCWORK_LTOKEN值和你配置的不一致，或者kwbuildproject路径对应其他版本的客户端，调整插件的Klocwork工具路径配置即可。

• 处理版本兼容性问题
  Klocwork Analysis Plug-in 2020.3的最低兼容Klocwork服务/客户端版本为2020.1，你当前使用的18.2版本客户端生成的ltoken格式无法被新版插件完全兼容。你可以二选一解决：

  1. 将Klocwork服务端和客户端升级到2020.1及以上版本，匹配插件要求
  2. 将Jenkins的Klocwork插件降级到和旧环境一致的1.18版本，恢复兼容性

内容的提问来源于stack exchange，提问作者Christophe Monfort