Jenkins Pipeline步骤未在指定Slave节点运行，反而执行于Master节点

嘿，刚入门Pipeline遇到这种节点调度问题太正常了，我帮好多Windows环境的朋友排查过类似情况，咱们一步步来搞定它！

最常见原因：Jenkinsfile里没正确指定代理节点 #

首先得确认你有没有在Pipeline脚本里明确指定要使用的代理节点——如果没写agent配置，Jenkins默认会把所有步骤都跑在Master上，这就是你看到Master路径的原因。

正确的写法应该是通过标签指定代理节点（标签要和你在Jenkins管理页面给代理节点设置的完全一致，Windows环境下标签大小写敏感哦）：

pipeline {
    // 指定要运行的代理节点，替换成你的节点标签
    agent { node { label 'windows-agent-01' } }
    
    stages {
        stage('测试节点调度') {
            steps {
                script {
                    // 打印当前节点名称，方便调试
                    println "当前运行节点: ${env.NODE_NAME}"
                    // 打印当前工作路径
                    println "工作目录路径: ${pwd()}"
                    // 创建测试文件验证
                    writeFile file: 'test.txt', text: '来自代理节点的测试内容'
                }
            }
        }
    }
}

如果你的Pipeline里有多个步骤需要在不同节点运行，也可以给单个stage指定agent：

pipeline {
    agent none // 全局不指定，每个stage单独设置
    stages {
        stage('在Master运行的步骤') {
            agent { node { label 'master' } }
            steps {
                echo "当前在Master: ${pwd()}"
            }
        }
        stage('在代理节点运行的步骤') {
            agent { node { label 'windows-agent-01' } }
            steps {
                echo "当前在代理节点: ${pwd()}"
            }
        }
    }
}

其他需要排查的点 #

1. 代理节点是否在线且正常连接 #

去Jenkins后台的「管理Jenkins」->「管理节点和云」，检查你的目标代理节点状态是不是「在线」：

• 如果显示「暂时离线」，看看节点有没有报错信息（比如JNLP连接失败、服务未启动）
• Windows代理节点要确保Jenkins Agent服务处于运行状态，防火墙没有阻断Master和代理节点的通信端口（默认是50000，或者你自定义的端口）

2. 项目配置和Pipeline脚本的冲突 #

如果你在项目的「配置」页面手动设置了「Restrict where this project can be run」（限制项目运行节点），这个设置可能会和Jenkinsfile里的agent配置冲突。建议优先用Jenkinsfile管理节点调度，把项目配置里的这个选项清空，避免冲突。

3. 代理节点的工作目录权限 #

检查Windows代理节点的「远程工作目录」（在节点配置页面设置）是否有足够的读写权限：

• 运行Jenkins Agent服务的用户（比如本地系统账户或指定的域账户）需要能在该目录下创建文件夹、写入文件
• 可以手动在代理节点的工作目录创建一个测试文件，验证权限是否正常

4. 调试小技巧 #

在Pipeline里加入println "${env.NODE_NAME}"可以直接打印当前运行的节点名称，快速确认步骤是不是真的跑在了错误的节点上，比看路径更直接。

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