Jenkins流水线中Shell脚本touch命令无法生成文件求助

原因1：文件生成路径不在预期位置 #

Jenkins流水线执行sh命令时，默认工作目录是流水线的工作空间（通常路径类似/var/lib/jenkins/workspace/[流水线名称]/），而非脚本所在的/dir/Jenkins/目录。你直接去脚本目录找文件自然看不到，实际上文件可能已经生成在Jenkins工作空间里了。

解决方法 #

修改Shell脚本，指定文件生成的绝对路径，确保你能找到：

echo "Generating file"
touch "/dir/Jenkins/genfile_$(date +"%Y_%m_%d_%I_%M_%p")"
echo "end of file..."

或者在脚本开头先切换到目标目录：

echo "Generating file"
cd /dir/Jenkins || exit 1
touch "genfile_$(date +"%Y_%m_%d_%I_%M_%p")"
echo "end of file..."

原因2：Jenkins运行用户无创建文件权限 #

Jenkins通常以jenkins系统用户运行，该用户可能没有在目标目录（无论是工作空间还是脚本目录）创建文件的权限。

解决方法 #

1. 检查目标目录权限：

ls -ld /dir/Jenkins/
# 或检查Jenkins工作空间权限
ls -ld /var/lib/jenkins/workspace/[你的流水线名称]/

2. 赋予jenkins用户对应权限：

# 更改目录归属
sudo chown -R jenkins:jenkins /dir/Jenkins/
# 或直接开放读写权限（按需调整）
sudo chmod -R 775 /dir/Jenkins/

原因3：日期格式的locale兼容问题 #

Jenkins运行环境的date命令locale设置可能和你本地Linux不同，导致%I（12小时制小时）或%p（AM/PM）解析异常，生成的文件名包含特殊字符（这种情况通常不会报错，但文件可能因名称问题被忽略）。

解决方法 #

在脚本中显式指定locale为C，确保日期格式一致：

echo "Generating file"
export LC_TIME=C
touch "genfile_$(date +"%Y_%m_%d_%I_%M_%p")"
echo "end of file..."

额外排查步骤 #

在Jenkins流水线的sh步骤里添加调试命令，快速定位问题：

pipeline {
    agent any

    stages {
        stage('Debug & Generate') {
            steps {
                sh '''
                    pwd
                    whoami
                    ls -l /dir/Jenkins/
                    /dir/Jenkins/genfile.sh
                '''
            }
        }
    }
}

通过输出可以明确当前工作目录、运行用户以及目录权限情况。

内容的提问来源于stack exchange，提问作者Vishnu Kumar K S