Jenkins执行pod install失败报invalid byte sequence in US-ASCII错误如何解决
问题根本原因
Jenkins执行Shell任务时默认使用非交互式登录态,不会加载当前用户目录下的.bash_profile、.zshrc等配置文件,因此本地修改的编码配置对Jenkins运行环境完全不生效,Ruby运行时默认使用US-ASCII编码解析包含非ASCII字符的项目配置文件时就会抛出该错误。
排查解决步骤
1. 临时修复单个Jenkins任务
在对应Jenkins任务的「执行Shell」模块最顶部,先添加编码环境变量配置,再执行pod install命令:
# 提前声明UTF-8编码环境变量 export LC_ALL=en_US.UTF-8 export LANG=en_US.UTF-8 # 修复日志提示的ffi扩展未构建问题,如提示权限不足可加sudo前缀 gem pristine ffi --version 1.14.2 # 再执行原有pod install命令 pod install
修改后重新执行任务即可验证修复效果。
2. 全局生效所有Jenkins任务
如果有多个iOS构建任务都需要该配置,可以直接把编码变量加入Jenkins全局环境:
- 打开Jenkins控制台,进入「系统管理」->「系统配置」页面
- 找到「全局属性」板块,勾选「环境变量」
- 新增两条环境变量:
- 键:
LC_ALL,值:en_US.UTF-8 - 键:
LANG,值:en_US.UTF-8
- 键:
- 保存配置后重启Jenkins服务,所有任务都会自动继承该编码配置。
3. 额外排查点
如果上述配置后仍报错,检查项目最近的变更:
- 项目的
.xcodeproj配置、Build Setting配置是否新增了非ASCII字符(比如中文命名的配置项、中文注释) - 确认所有项目配置文件的编码格式为UTF-8,避免Ruby解析时识别异常
内容的提问来源于stack exchange,提问作者mmi
相关产品推荐
相关产品推荐

