Jenkins Pipeline中fileExists判断为false但文件实际存在，求排查思路

问题描述 #

Jenkins Pipeline执行时，"Code Coverage Tests"阶段在容器main内成功生成/coverage-data/_coverage_report.dat，ls命令输出也确认文件存在，但后续"Code Coverage Scan"阶段的when条件expression { return fileExists('/coverage-data/_coverage_report.dat') }返回false，导致该阶段被跳过，常规方案尝试后无效。

相关Pipeline代码片段 #

stage('Code Coverage Tests') {
    steps {
        container('main') {
            catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') {
                sh '''
                pwd
                echo testinfo > /coverage-data/_coverage_report.dat
                ls -ltr /coverage-data/
                '''.stripIndent()
            }
        }
    }
}
stage('Code Coverage Scan') {
    when { expression { return fileExists ('/coverage-data/_coverage_report.dat') } }
    steps {
        // 阶段执行内容
    }
}

执行输出片段 #

+ ls -ltr /coverage-data/
total 4
-rw-r--r-- 1 jenkins jenkins 9 Dec 18 18:13 _coverage_report.dat
+ pwd
[Pipeline] stage
[Pipeline] { (Code Coverage Scan)
[Pipeline] fileExists
Stage "Code Coverage Scan" skipped due to when conditional

排查思路 #

• 容器与代理节点文件系统隔离：文件是在容器main内部生成的，而fileExists默认检查的是Jenkins代理节点（宿主机）的文件系统，若两个阶段不在同一容器上下文，宿主机无法访问容器内的文件。需确保Code Coverage Scan阶段也运行在container('main')中，或通过挂载卷将容器内的/coverage-data同步到代理节点的共享路径。
• 阶段上下文不一致：检查Code Coverage Scan阶段的执行上下文，是否和生成文件的容器环境一致。如果该阶段直接在代理节点上执行，自然找不到容器内的文件。
• 路径权限验证：即使路径存在，Jenkins代理节点的执行用户可能无访问/coverage-data的权限，导致fileExists检测失败。可在Code Coverage Scan阶段的when条件前先执行对应上下文的ls -ltr /coverage-data/命令，手动验证文件是否可访问。
• 路径解析混淆：确认/coverage-data在代理节点上是否为有效绝对路径，若容器内的路径是挂载代理节点的子目录，需改用代理节点上的实际路径进行检查。
• Jenkins状态异常：偶尔Jenkins的文件检查逻辑存在缓存或状态异常，可尝试在when条件中添加手动执行的shell命令验证文件存在性，或重启Jenkins代理节点排除异常。

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