Jenkins Pipeline 的 readYaml 工具步骤基于 SnakeYAML 实现，默认允许重复键且静默覆盖（不报错），这是由底层 LoaderOptions.allowDuplicateKeys = true 决定的，符合 YAML 规范对“非法重复键”的宽松处理策略。
jenkins pipeline 的 `readyaml` 工具步骤基于 snakeyaml 实现，默认允许重复键且静默覆盖（不报错），这是由底层 `loaderoptions.allowduplicatekeys = true` 决定的，符合 yaml 规范对“非法重复键”的宽松处理策略。
在 Jenkins Pipeline 中，readYaml 是一个常用工具步骤，用于将 YAML 文件或字符串解析为 Groovy Map 对象，便于后续逻辑处理。然而，当 YAML 内容包含重复键（如两个同名顶级 key）时，开发者常惊讶于其“无异常通过”且仅保留最后一个键值对的行为：
# example.yaml key1: subkey1: val1 key2: subkey2: val2 key2: # ← 重复键，与上一行相同 subkey2: val3 # ← 此值生效，前一个 key2 被完全丢弃
执行如下 Pipeline 片段后：
def config = readYaml file: 'example.yaml'
echo "Parsed: ${config}"输出为：
Parsed: [key1:[subkey1:val1], key2:[subkey2:val3]]
可见 key2 的第一个定义被静默覆盖，未抛出任何警告或错误。
原因解析：SnakeYAML 的默认行为
Jenkins pipeline-utility-steps 插件内部使用 SnakeYAML 的 SafeConstructor 进行解析。根据 SnakeYAML 源码，当 LoaderOptions.allowDuplicateKeys == true（默认值）时，重复键会被静默跳过，仅保留最后一次出现的值：
// SnakeYAML SafeConstructor.java 简化逻辑
if (allowDuplicateKeys && existingKey != null) {
// 不报错，直接跳过当前重复键，继续解析
continue;
}值得注意的是：YAML 1.2 规范明确禁止重复映射键（见 spec section 3.2.2.1），因此严格来说，含重复键的 YAML 是非法文档。但 SnakeYAML 为兼容性考虑，默认启用宽容模式（allowDuplicateKeys=true），而 Jenkins 插件未显式禁用该选项。
如何检测并避免重复键问题？
虽然 readYaml 本身不提供校验开关，但可通过以下方式主动防御：
✅ 预校验 YAML 合法性（推荐）
在 readYaml 前使用 sh 调用 yamllint 或 python -c "import yaml; yaml.safe_load(open('f.yml'))" 进行静态检查：
sh 'yamllint -d "{extends: relaxed, rules: {key-duplicates: {level: error}}}" example.yaml'
def config = readYaml file: 'example.yaml' // 仅当校验通过后执行✅ 自定义解析（高级场景）
若需在 Pipeline 中强制校验，可借助 script 块调用 Java SnakeYAML API 并设置 allowDuplicateKeys = false：
script {
def loaderOptions = new org.yaml.snakeyaml.LoaderOptions()
loaderOptions.setAllowDuplicateKeys(false) // ← 关键：禁止重复键
def yaml = new org.yaml.snakeyaml.Yaml(
new org.yaml.snakeyaml.constructor.SafeConstructor(loaderOptions)
)
def content = readFile('example.yaml')
def parsed = yaml.load(content)
}⚠️ 注意：此方式需确保 Jenkins agent 环境中存在 SnakeYAML 依赖（通常已内置），且需处理 org.yaml.snakeyaml.constructor.DuplicateKeyException 异常。
总结
- readYaml 静默忽略重复键是 SnakeYAML 默认行为，非 Jenkins Bug；
- 该行为虽提高容错性，但易掩盖配置错误，建议在 CI 流程中加入 YAML 语法校验；
- 生产环境 YAML 配置应遵循规范，杜绝重复键；CI 流水线宜将 YAML 校验作为门禁步骤（Gate Step），而非依赖 readYaml 自动纠错。
