Jenkins 运行任务时遇到 FATAL:Unable to produce a script file 报错(已解决)

2023-03-24 10:29:11 浏览数 (2)

关键词:Jenkins、Unable to produce a script file、UnmappableCharacterException、IOException: Failed to create a temp file on

若移动端访问不佳,请使用 –> GithubPage 版

0x00 问题描述

由于使用的 Jenkins 存在安全漏洞(详见 Jenkins Security Advisory 2023-03-08),需要升级到已解决安全漏洞的新版本,更新后运行任务时出现了报错:FATAL: Unable to produce a script file

详细的报错日志如下:

代码语言:javascript复制
# 拉取代码的 Commit 信息
16:21:35 Commit message: "feat: ????"
# 堆栈信息
16:21:35 FATAL: Unable to produce a script file
16:21:35 java.nio.charset.UnmappableCharacterException: Input length = 1
16:21:35 	at java.base/java.nio.charset.CoderResult.throwException(CoderResult.java:275)
16:21:35 	at java.base/sun.nio.cs.StreamEncoder.implWrite(StreamEncoder.java:306)
16:21:35 	at java.base/sun.nio.cs.StreamEncoder.implWrite(StreamEncoder.java:281)
16:21:35 	at java.base/sun.nio.cs.StreamEncoder.write(StreamEncoder.java:125)
16:21:35 	at java.base/java.io.OutputStreamWriter.write(OutputStreamWriter.java:208)
16:21:35 	at java.base/java.io.BufferedWriter.flushBuffer(BufferedWriter.java:120)
16:21:35 	at java.base/java.io.BufferedWriter.close(BufferedWriter.java:268)
16:21:35 	at hudson.FilePath$CreateTextTempFile.invoke(FilePath.java:1658)
16:21:35 	at hudson.FilePath$CreateTextTempFile.invoke(FilePath.java:1628)
16:21:35 	at hudson.FilePath.act(FilePath.java:1198)
16:21:35 	at hudson.FilePath.act(FilePath.java:1181)
16:21:35 	at hudson.FilePath.createTextTempFile(FilePath.java:1622)
16:21:35 Caused: java.io.IOException: Failed to create a temp file on /var/jenkins_home/workspace/xxx
16:21:35 	at hudson.FilePath.createTextTempFile(FilePath.java:1624)
16:21:35 	at hudson.tasks.CommandInterpreter.createScriptFile(CommandInterpreter.java:202)
16:21:35 	at hudson.tasks.CommandInterpreter.perform(CommandInterpreter.java:120)
16:21:35 	at hudson.tasks.CommandInterpreter.perform(CommandInterpreter.java:92)
16:21:35 	at hudson.tasks.BuildStepMonitor$1.perform(BuildStepMonitor.java:20)
16:21:35 	at hudson.model.AbstractBuild$AbstractBuildExecution.perform(AbstractBuild.java:818)
16:21:35 	at hudson.model.Build$BuildExecution.build(Build.java:199)
16:21:35 	at hudson.model.Build$BuildExecution.doRun(Build.java:164)
16:21:35 	at hudson.model.AbstractBuild$AbstractBuildExecution.run(AbstractBuild.java:526)
16:21:35 	at hudson.model.Run.execute(Run.java:1900)
16:21:35 	at hudson.model.FreeStyleBuild.run(FreeStyleBuild.java:44)
16:21:35 	at hudson.model.ResourceController.execute(ResourceController.java:101)
16:21:35 	at hudson.model.Executor.run(Executor.java:442)
16:21:35 Build step 'Execute shell' marked build as failure

0x01 定位原因

根本原因隐藏在日志信息里:

  1. 首先,可以看到 Commit message: "feat: ????" 中的中文内容变成了乱码 ????
  2. 从堆栈信息里 java.nio.charset.UnmappableCharacterException: Input length = 1 可知,这是个和字符集相关的报错信息:

这个错误是由于Java运行时无法将一个输入的字符映射为所需要的字符集(通常是Unicode)而引起的。可能会发生这种情况: 输入的文本包含了一个你使用的字符集无法映射的字符。 如果文本在不同的平台上被创建和传输,则可能会发生此错误,因为每个平台使用的默认字符集可能不同。 为了解决这个错误,你可以尝试以下方法:

  1. 检查你的字符集: 在你的代码中,确保你所使用的字符集和输入文本的字符集匹配。
  2. 检查文本: 检查输入文本中是否有在使用字符集时无法映射的字符或符号。
  3. 指定字符集: 明确指定字符集,尤其是在不同平台之间传输文本时。最好使用标准字符集,例如UTF-8或ISO-8859-1等。 如果以上解决方法都无效,你可能需要查看代码以确定是否有其他问题。

0x02 解决方案

既然是字符集(文件编码)相关的问题,解决方案有 2 个思路:

  1. 去掉 Jenkins Job 里脚本和指令中的中文等字符
  2. 让 Jenkins 的运行环境支持 UTF-8 编码,以正常处理和展示中文内容

方案一:移除无法正常处理和显示的中文内容

进入 Jenkins Job 的配置中,定位报错的步骤卡到哪一个环节,查看脚本和指令是否使用了中文内容(注释也算)。

在我的 Job 配置是 Build Steps - 执行 shell 的 shell 脚本中,对指令做了中文注释,移除调中文内容,保存并重新执行一下 Job 的运行任务,发现可以正常完成构建任务了。

方案二:让 Jenkins 支持中文

让 Jenkins 正确处理和展示中文,有 2 个方法,可以根据自身情况进行设置:

  1. 设置机器的 LANG=”C.UTF-8”
  2. ENKINS_JAVA_OPTS 或者 JAVA_OPTS 的值增加 -Dfile.encoding=UTF8 的内容

这里推荐修改 LANG 的值来支持中文:

由于我使用 Docker 方式安装的 Jenkins,所以只需要在创建 container 时设置 -e LANG="C.UTF-8" 即可;如何你使用 portainer 或者 Docker Compose,可自行查找设置、修改环境变量的方法。

对于 ENKINS_JAVA_OPTS 或者 JAVA_OPTS 的值增加 -Dfile.encoding=UTF8 的内容:

注意一点,ENKINS_JAVA_OPTS 只影响 Jenkins 程序;JAVA_OPTS 则会影响所有本机器下所有基于 Java 运行的程序。 至于修改方式,参考上面修改 LANG 的过程。

最后,对修改是否生效进行检查:

设置完毕并重启 Jenkins 后,如果你是管理员,进入 Dashboard-系统管理-系统信息-环境变量 查看下当前 Jenkins 的环境变量:

  1. 检查 LANG 的值,查看下是否为 C.UTF-8 ;
  2. 或者,查看 JENKINS_JAVA_OPTS 或者 JAVA_OPTS 的值里是否有 -Dfile.encoding=UTF8
  3. 最后,运行一下之前 Job 的构建任务,看看能否正常显示中文和正常完成构建。

其他方案

网上也有一些别的方案,如果报错信息中没有 java.nio.charset.UnmappableCharacterException: Input length = 1 的信息,可能就不是编码问题。可以尝试:

  1. 重启 Jenkins
  2. 可能磁盘空间不足,可尝试删除 /tmp/ 缓存目录下的文件
  3. 可能目录权限不正确,尝试把 Job 的 workspace 所在目录修改为 jenkins 能够读写的用户权限

0x03 总结

定位问题的过程中,首先检索报错信息中的 Unable to produce a script file,有很多资料都没有说明为什么要使用文章里的解决方案,仅仅是做个记录,没有深入追溯原因,走了不少弯路。

之后,结合 Commit 信息乱码,检索报错信息中的 java.nio.charset.UnmappableCharacterException: Input length = 1,终于找到核心原因:文件编码问题。之后一路查官方文档等,找到了合适的解决方案。

资料:

  • Jenkins 的 Docker 安装文档
  • Jenkins 安装文档

0 人点赞