Jenkins工作目录自动追加@2的原因及彻底修复方案咨询

以下是几个经过验证的彻底修复方案，按优先级尝试：

1. 核对节点与任务的工作空间配置 #

• 进入Jenkins节点管理页面，确认对应代理的「工作空间根目录」为固定路径（如D:\WorkingDirectory），未使用动态占位符或重复配置项
• 检查所有关联任务的「自定义工作空间」设置，确保没有任务误配置为动态生成路径，且同一代理上的任务不会强制共享存在冲突的工作空间路径

2. 清理残留锁文件与异常目录 #

• 直接删除代理机器上的D:\WorkingDirectory@2目录
• 在Jenkins节点管理中选中对应代理，点击「清理工作空间」，再选择「重启代理」
• 检查Jenkins工作空间根目录下的.lock文件，若存在已结束构建遗留的未释放锁文件，手动删除这些文件

3. 通过启动参数禁用自动后缀 #

在Jenkins启动脚本中添加以下参数，强制阻止Jenkins创建带@后缀的工作空间副本：

-Djenkins.model.WorkspaceLocatorImpl.disableSymlink=true

添加完成后重启Jenkins服务，该参数会让Jenkins始终使用原始工作空间路径，不再生成备用目录

4. 排查插件干扰 #

• 禁用近期安装或更新的插件（尤其是Workspace Cleanup、Parallel Build类插件），测试问题是否消失
• 将核心插件与常用插件更新至最新稳定版本，部分旧版本插件存在工作空间命名逻辑的bug

内容的提问来源于stack exchange，提问作者Gabriel Lacey