Jenkins iOS Agent 的 Git LFS Checkout 失败排查
背景 某 iOS 工程把约 132 个 vendored gem(iot/vendor/cache/*.gem)通过 git-filter-repo 迁到了 Git LFS 并 force-push。此前这些 gem 是普通 git blob,checkout 不触发 git-lfs。迁移后,Jenkins 的 iOS agent(由 launchd 拉起、无 GUI 会话)第一次 checkout 到含 LFS 内容的版本,问题才暴露。 为什么会「以前没事、今天突然挂」:① 仓库是最近才引入 LFS 的,以前 checkout 根本不触发 git-lfs;② launchd agent 从一开始就没有 GUI 会话 / 完整 PATH,只是以前没被需要。 名词解释 Git LFS:Git 大文件存储,把大文件(此处是 gem 包)存到独立对象存储,工作区 checkout 时通过 smudge 过滤器按需下载。 smudge / clean / filter-process:LFS 的过滤器钩子;checkout 时的 smudge 负责把指针换成真实文件。 osxkeychain:macOS 系统级 Git 凭据助手,从登录钥匙串读凭据;无登录会话的后台进程读不到。 credential.helper:Git 的凭据获取机制;空值会清空下层继承的 helper。 现象(错误随修复逐层演进) 轮次 报错 所属层面 1 git-lfs: command not found agent PATH 不含 Homebrew 2(手动配 filter 配坏) filter-process: command not found filter.lfs.process 配成裸 filter-process 3(改绝对路径后) failed to get: -60008 osxkeychain 在 launchd 下读不了登录钥匙串 4(禁用 osxkeychain 后) batch response: too many authentication attempts git-lfs 拿不到 LFS 接口凭据 三层报错各不相同,是典型的「修好一层、暴露下一层」。 ...