Jenkins 2.107.1：SCM检出后无法访问仓库文件或目录求助

针对你遇到的「文件实际存在，但Jenkins无法访问该文件或进入仓库目录」的问题，结合你提供的Jenkins版本和流水线片段，我整理了几个实用的排查和解决方法：

1. 优先检查Jenkins运行用户的权限 #

Jenkins默认以jenkins系统用户运行（不同系统可能有差异），大部分权限问题都是因为这个用户没有目标目录/文件的访问权限。

• 你可以登录Jenkins服务器，执行以下命令验证权限（替换为你的仓库路径）：

  sudo -u jenkins ls -l /var/lib/jenkins/workspace/your-job-name
  

  如果返回权限拒绝的错误，就需要调整目录权限：

  sudo chown -R jenkins:jenkins /var/lib/jenkins/workspace/your-job-name
  # 或者开放其他用户的读权限（按需使用）
  sudo chmod -R o+r /path/to/your/repo
  

2. 确认Git Checkout是否真的成功 #

你的流水线里的Checkout步骤配置了分支规则*/*********，要先确认这个规则是正确的（比如应该是*/main或*/develop这类有效分支格式）。另外，建议在流水线里添加调试步骤，验证代码是否拉取到了工作空间：

node {
    stage('Checkout SCM') {
        checkout([$class: 'GitSCM', branches: [[name: '*/*********']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: '******', url: 'https://github.com/******']]])
    }
    // 添加调试步骤，查看当前路径和文件列表
    stage('Debug Workspace') {
        sh 'pwd'
        sh 'ls -la'
    }
    stage('Copy the file from the Jenkins-script...') {
        // 你的复制逻辑
    }
}

查看构建日志里的Debug Workspace输出，确认目标文件是否存在于工作空间中。

3. 清理Jenkins工作空间 #

旧版本的Jenkins（比如你的2.107.1）有时候会因为工作空间缓存导致文件访问异常，你可以安装「Workspace Cleanup Plugin」后，在流水线开头添加清理步骤：

node {
    cleanWs() // 清理工作空间
    stage('Checkout SCM') {
        // 你的Checkout代码
    }
    // 后续步骤
}

4. 考虑Jenkins版本的局限性 #

Jenkins 2.107.1是2018年发布的旧版本，存在不少已知的权限和工作空间管理bug，如果以上方法都无效，建议升级到LTS版本（比如当前的2.46.x系列），新版本不仅修复了旧bug，还提升了安全性和稳定性。

内容的提问来源于stack exchange，提问作者rohan gupta