<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Git LFS on Last Stand</title><link>https://amatsuzero.github.io/LastStand/tags/git-lfs/</link><description>Recent content in Git LFS on Last Stand</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Thu, 22 Oct 2026 15:22:27 +0800</lastBuildDate><atom:link href="https://amatsuzero.github.io/LastStand/tags/git-lfs/index.xml" rel="self" type="application/rss+xml"/><item><title>Jenkins iOS Agent 的 Git LFS Checkout 失败排查</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-ios-jenkins-lfs/</link><pubDate>Thu, 22 Oct 2026 15:22:27 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-ios-jenkins-lfs/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;某 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 内容的版本，问题才暴露。&lt;/p&gt;
&lt;p&gt;为什么会「以前没事、今天突然挂」：① 仓库是最近才引入 LFS 的，以前 checkout 根本不触发 git-lfs；② launchd agent 从一开始就没有 GUI 会话 / 完整 PATH，只是以前没被需要。&lt;/p&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Git LFS&lt;/strong&gt;：Git 大文件存储，把大文件（此处是 gem 包）存到独立对象存储，工作区 checkout 时通过 smudge 过滤器按需下载。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;smudge / clean / filter-process&lt;/strong&gt;：LFS 的过滤器钩子；checkout 时的 smudge 负责把指针换成真实文件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;osxkeychain&lt;/strong&gt;：macOS 系统级 Git 凭据助手，从登录钥匙串读凭据；无登录会话的后台进程读不到。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;credential.helper&lt;/strong&gt;：Git 的凭据获取机制；空值会清空下层继承的 helper。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="现象错误随修复逐层演进"&gt;现象（错误随修复逐层演进）&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;轮次&lt;/th&gt;
&lt;th&gt;报错&lt;/th&gt;
&lt;th&gt;所属层面&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;git-lfs: command not found&lt;/td&gt;
&lt;td&gt;agent PATH 不含 Homebrew&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2（手动配 filter 配坏）&lt;/td&gt;
&lt;td&gt;filter-process: command not found&lt;/td&gt;
&lt;td&gt;filter.lfs.process 配成裸 filter-process&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3（改绝对路径后）&lt;/td&gt;
&lt;td&gt;failed to get: -60008&lt;/td&gt;
&lt;td&gt;osxkeychain 在 launchd 下读不了登录钥匙串&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4（禁用 osxkeychain 后）&lt;/td&gt;
&lt;td&gt;batch response: too many authentication attempts&lt;/td&gt;
&lt;td&gt;git-lfs 拿不到 LFS 接口凭据&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;三层报错各不相同，是典型的「修好一层、暴露下一层」。&lt;/p&gt;</description></item></channel></rss>