You need to enable JavaScript to run this app. Jenkins执行pod install失败报invalid byte sequence in US-ASCII错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 07:12:03