Jenkinsfile无法调用Git仓库中Python脚本的问题求助

核心原因 #

Jenkins流水线执行时的工作目录是Git仓库的根目录，而非Jenkinsfile所在的子目录（你的Jenkinsfile在test-pipeline/下）。你之前用相对路径时，错误地以Jenkinsfile所在目录为基准，导致找不到脚本。

正确路径设置方法 #

1. 明确仓库结构
   先梳理你的仓库目录结构（示例参考）：

   jenkins_scripts/
   ├── test-pipeline/
   │   └── Jenkinsfile.groovy
   └── scripts/
       ├── my_script.py
       └── another_script.py
   

2. 基于仓库根目录写相对路径
   在Jenkinsfile中调用Python脚本时，路径要从仓库根目录开始计算：

   pipeline {
       agent any
       stages {
           stage('Run Python Script') {
               steps {
                   // 打印当前工作目录，用于验证
                   sh 'pwd'
                   // 调用仓库根目录下scripts/里的脚本
                   sh 'python ./scripts/my_script.py'
               }
           }
       }
   }
   

   比如如果脚本直接在仓库根目录，就用python ./my_script.py；如果在test-pipeline/同层级的其他目录，直接写./<目录名>/<脚本名>即可。

3. 验证路径正确性
   可以在流水线中添加目录查看命令，确认脚本是否存在：

   sh 'ls -la ./scripts/'
   

   这能帮你快速排查是路径写错，还是脚本根本没被Jenkins拉取到。

常见坑排查 #

• 脚本被.gitignore排除：检查仓库的.gitignore文件，确保Python脚本没有被忽略，导致Jenkins拉取仓库时未同步该文件。
• Docker Agent的目录挂载问题：如果流水线使用了Docker agent，需确认Jenkins默认的工作空间目录被正确挂载到容器内（默认流水线会自动挂载，但自定义volume配置时可能出错）。
• 脚本权限问题：如果直接执行脚本（比如./scripts/my_script.py），需要确保脚本有可执行权限（chmod +x），否则用python命令调用更稳妥。

替代方案（如果路径仍有问题） #

可以通过env.WORKSPACE变量获取Jenkins工作空间的绝对路径，拼接脚本路径：

sh "python ${env.WORKSPACE}/scripts/my_script.py"

但优先推荐相对路径，更灵活。

内容的提问来源于stack exchange，提问作者mr. lova