git mirror: StoreMissingLfsObjectsInRepository

[xqxyxchy]

Gitea Version

1.26.2

What happened?

the source git has lfs file.git mirror failed.
--log
6月 12 10:39:18 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:18 HTTPRequest [I] router: completed POST /ibase-ui/ui-report/settings/migrate/retry for 47.106.216.174:0, 200 OK in 28.7ms @ repo/migrate.go:268(repo.MigrateRetryPost)
6月 12 10:39:18 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:18 HTTPRequest [I] router: completed GET /ibase-ui/ui-report for 47.106.216.174:0, 200 OK in 32.3ms @ repo/view_home.go:389(repo.Home)
6月 12 10:39:18 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:18 HTTPRequest [I] router: completed GET /ibase-ui/ui-report/-/migrate/status for 47.106.216.174:0, 200 OK in 14.6ms @ repo/migrate.go:295(repo.MigrateStatus)
6月 12 10:39:21 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:21 HTTPRequest [I] router: completed GET /ibase-ui/ui-report/-/migrate/status for 47.106.216.174:0, 200 OK in 14.7ms @ repo/migrate.go:295(repo.MigrateStatus)
6月 12 10:39:22 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:22 HTTPRequest [I] router: polling GET /user/events for 47.106.216.174:0, elapsed 3876.1ms @ events/events.go:18(events.Events)
6月 12 10:39:24 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:24 HTTPRequest [I] router: completed GET /ibase-ui/ui-report/-/migrate/status for 47.106.216.174:0, 200 OK in 14.8ms @ repo/migrate.go:295(repo.MigrateStatus)
6月 12 10:39:27 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:27 HTTPRequest [I] router: completed GET /ibase-ui/ui-report/-/migrate/status for 47.106.216.174:0, 200 OK in 15.1ms @ repo/migrate.go:295(repo.MigrateStatus)
6月 12 10:39:27 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:27 .../repository/migrate.go:165:MigrateRepositoryGitData() [E] Failed to store missing LFS objects for repository:
6月 12 10:39:27 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:27 services/task/migrate.go:60:runMigrateTask.1() [E] runMigrateTask[38] by DoerID[2] to RepoID[63] for OwnerID[14] failed: StoreMissingLfsObjectsInRepository:
6月 12 10:39:27 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:27 services/task/task.go:53:handler() [E] Run task failed: StoreMissingLfsObjectsInRepository:
6月 12 10:39:29 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:29 HTTPRequest [I] router: completed GET / for 127.0.0.1:57140, 200 OK in 2.9ms @ web/home.go:32(web.Home)
6月 12 10:39:30 iZwz9a8scx4z0kbmyyj0a3Z gitea[976382]: 2026/06/12 10:39:30 HTTPRequest [I] router: completed GET /ibase-ui/ui-report/-/migrate/status for 47.106.216.174:0, 200 OK in 26.7ms @ repo/migrate.go:295(repo.MigrateStatus)

How are you running Gitea?

centos7
binary
git 2.13.1
git-lfs 3.7.1

--app.ini
[server]
LFS_START_SERVER = true

[lfs]
PATH = /home/gitea/data/lfs

[xqxyxchy]

create new git in gitea,init lfs, it can't push to remote.

[xqxyxchy]

debug log ：
failed: StoreMissingLfsObjectsInRepository: LFS client version too old, please upgrade your LFS client greater than v2.4.0

[wxiaoguang]

• mirror: LFS client version too old mirror: LFS client version too old #32611
• In some lfs server implementations, they require the ref attribute. In some lfs server implementations, they require the ref attribute. #32838

Then

• Unable to migrrate repos from Hugging Face Unable to migrrate repos from Hugging Face #33453
• Revert empty lfs ref name Revert empty lfs ref name #33454

[xqxyxchy]

• mirror: LFS client version too old mirror: LFS client version too old #32611
• In some lfs server implementations, they require the ref attribute. In some lfs server implementations, they require the ref attribute. #32838

Then

• Unable to migrrate repos from Hugging Face Unable to migrrate repos from Hugging Face #33453
• Revert empty lfs ref name Revert empty lfs ref name #33454

The fix in #32838 was undone by #33454, so how should we deal with this problem?

[xqxyxchy]

create new git in gitea,init lfs, it can't push to remote.

@wxiaoguang How do we solve this problem?

[wxiaoguang]

No idea

[xqxyxchy]

Can we consider adding a parameter to the interface for the weird case to control whether to pass an empty ref or nil?

[wxiaoguang]

https://github.com/git-lfs/git-lfs/blob/a32a02b44bf8a511aa14f047627c49e1a7fd5021/docs/api/batch.md?plain=1#L69-L72

Maybe either:

1. Ask your mirror server to fix their bug: servers should be able to operate with a missing or null ref property.
2. Add a repo-level setting option
3. Try to pass "null (nil)" as "ref" to see whether your mirror server likes it, if yes: this is the best approach

[wxiaoguang]

Try to pass "null (nil)" as "ref" to see whether your mirror server likes it, if yes: this is the best approach

You can remove the omitempty from Ref *Reference `json:"ref,omitempty"` and build your own binary to try