Jenkins流水线报错Unknown stage section "stage" 如何解决？

错误根因 #

你当前的Pipeline语法不符合Jenkins声明式流水线的规范，核心问题有2个：

• 顶层stages块下仅允许直接嵌套stage子块，你将parallel块直接和stage平级放在stages下，属于语法结构错误
• parallel块中不允许同时混合嵌套独立stage和stages块，结构不合法

修正后的配置示例 #

如果要在Header_2之后执行并行任务，需要先把并行逻辑包裹在一个外层的stage中，再在外层stage下开启并行，示例如下：

pipeline {
    agent any
    stages {
        stage('Header_1'){
            steps{}
        }
        stage('Header_2'){
            steps{}
        }
        // 并行逻辑必须包裹在一个独立stage中
        stage('Parallel Tasks'){
            parallel {
                stage('First Parallel Stage'){
                    environment {
                        // 此处填写你的环境变量配置
                    }
                    steps {
                        // 该并行stage的执行步骤，无实际逻辑也需保留空块
                        echo "执行第一个并行任务"
                    }
                }
                stage('Another Parallel Group'){
                    stages {
                        stage('Another_One'){
                            steps{}
                        }
                        // 可继续添加同组内的串行stage
                    }
                }
            }
        }
     }
 }

注意事项 #

• 所有stage块下必须包含steps块，没有实际执行逻辑也需要保留空的steps{}，不能省略
• 如果需要嵌套多层stage，只能在某个父stage下嵌套stages块，不能和同级的其他stage混合放在parallel下
• 你之前添加空steps无效的核心原因是外层的parallel位置错误，修正位置后即可正常生效

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