如何在Jenkins Pipeline中读取Properties文件并拆分键值对

场景说明 #

待读取的Properties文件（mypropsfile.properties）内容：

product1=workspacename1:path1/path2/path3
product2=workspacename2:path1/path2/path3
product3=workspacename3:path1/path2/path3

需求：在Jenkins Pipeline中逐行读取该文件，拆分每个键值对的键、值，同时将值进一步拆分为工作区名称和路径，不通过硬编码键名获取对应值。

错误原因分析 #

1. 使用readProperties方法时，返回的是Map<String, String>类型对象，遍历该对象时拿到的是java.util.AbstractMap$SimpleImmutableEntry实例，而非字符串，因此调用split("=")会触发MissingMethodException——该对象没有字符串的split方法。
2. 使用readFile读取文件后，内层循环for (String splittingparams : PropsFileValue)实际是遍历字符串的每个字符，而非拆分后的工作区名称和路径片段，逻辑错误。

正确实现脚本 #

stage('readfromfile') {
    steps {
        script {
            // 读取文件完整内容
            def fileContent = readFile file: 'mypropsfile.properties'
            
            // 按行分割内容，遍历每一行并处理
            fileContent.split('\n').each { line ->
                // 跳过空行和注释行（若文件存在注释）
                def trimmedLine = line.trim()
                if (trimmedLine && !trimmedLine.startsWith('#')) {
                    // 拆分键和值，限制仅拆分1次（避免值中包含=符号）
                    def (key, value) = trimmedLine.split('=', 2)
                    echo "键：${key}"
                    echo "原始值：${value}"
                    
                    // 拆分值为工作区名称和路径，同样限制拆分1次
                    def (workspaceName, fullPath) = value.split(':', 2)
                    echo "工作区名称：${workspaceName}"
                    echo "完整路径：${fullPath}"
                    
                    // 可选：进一步拆分路径为片段
                    def pathSegments = fullPath.split('/')
                    echo "路径片段列表：${pathSegments}"
                    // 示例：获取路径的第二个片段（索引从0开始）
                    // if (pathSegments.size() >= 2) echo "二级路径：${pathSegments[1]}"
                }
            }
        }
    }
}

关键要点 #

• 用readFile读取纯文本内容，确保可以逐行处理，避免readProperties返回Map带来的类型问题。
• 使用split('=', 2)和split(':', 2)限制拆分次数，防止值中包含分隔符导致的拆分错误。
• 加入空行和注释行过滤逻辑，提升脚本健壮性。
• 全程无需硬编码键名，自动遍历处理所有键值对。

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