Jenkins TFS插件偶发NumberFormatException问题求助

从你提供的错误栈来看，这个偶发的NumberFormatException是因为TFS插件在解析日期版本规范（DateVersionSpec）时，意外拿到了空字符串，导致无法将其转换为Long类型。这种偶发问题通常和工作区缓存、插件版本缺陷或者TFS服务器响应异常有关，以下是几个你可能遗漏的解决方案：

1. 禁用工作区更新模式，改用重新创建工作区 #

你当前的checkout配置中使用了useUpdate: true，这个选项会让Jenkins尝试复用现有工作区并更新代码，但偶尔旧工作区的缓存版本信息可能损坏或返回空值。改成useUpdate: false，让每次构建都重新创建干净的工作区，避免缓存带来的异常：

withCredentials([usernamePassword( credentialsId: 'amer-o9-ServiceAdmin', passwordVariable: 'pass', usernameVariable: 'user' )]) {
    def secret = hudson.util.Secret.fromString(pass)
    checkout( changelog: false, scm: [ 
        $class: 'TeamFoundationServerScm', 
        localPath: '\\', 
        userName: user, 
        password: secret, 
        projectPath: '$/my_workspace/my_project', 
        serverUrl: properURL, 
        useUpdate: false,  // 这里改为false
        workspaceName: "HUDSON-${env.JOB_NAME}-${env.NODE_NAME}" 
    ] )
}

2. 升级TFS插件到最新稳定版 #

你使用的TFS插件版本是5.157.1，这个版本发布时间较早，后续版本很可能修复了这种偶发的日期解析边界问题。建议升级到Jenkins插件市场上的最新稳定版，很多用户反馈类似的偶发异常在新版本中得到了解决。

3. 显式指定代码版本，避免自动解析日期版本 #

插件默认会自动尝试解析上次构建的版本信息，偶尔会出现空值情况。你可以在checkout配置中显式指定版本，比如拉取最新版本：

withCredentials([usernamePassword( credentialsId: 'amer-o9-ServiceAdmin', passwordVariable: 'pass', usernameVariable: 'user' )]) {
    def secret = hudson.util.Secret.fromString(pass)
    checkout( changelog: false, scm: [ 
        $class: 'TeamFoundationServerScm', 
        localPath: '\\', 
        userName: user, 
        password: secret, 
        projectPath: '$/my_workspace/my_project', 
        serverUrl: properURL, 
        useUpdate: true,
        workspaceName: "HUDSON-${env.JOB_NAME}-${env.NODE_NAME}",
        version: 'LATEST'  // 显式指定拉取最新版本
    ] )
}

你也可以指定具体的变更集号，比如version: 'C12345'，这样插件就不会去自动解析可能为空的日期版本字符串了。

4. 检查Jenkins节点与TFS服务器的时间同步 #

虽然是偶发情况，但如果Jenkins构建节点和TFS服务器的时间、时区不一致，可能导致日期解析时出现异常。确保所有构建节点的时间和TFS服务器保持同步，避免时区差异带来的解析问题。

内容的提问来源于stack exchange，提问作者Sunny Redhu