Files
knowledge-governance/internal/objectgateway/create.go
T
姚章浩 a55319d972
build / build (push) Failing after 2m29s
fix(objectgateway): 取消整桶独占前置并按维护停写更新
现象:共享桶部署下网关启动即报 gateway_auditor_key_required,残留过期
审计文件则每次 Execute 报 gateway_exclusive_writer_evidence_unverified;
用户已改为“停目标写入容器→更新→启动”的维护式更新。

根因:Gateway.Ready 强制 Isolation.Verify,main 强制 Ed25519 公钥,等于
把整桶独占证明当作发布前置;这与共享桶、沿用原 AK 的实际部署矛盾。

取舍:删除审计校验与相关 env 依赖,保留 journal、治理 PG 只读 authority、
plan/owner/attempt/epoch 绑定、intent-before-send、单次写与精确版本回滚。
create 仅在精确版本读回且仍为 current 时提交;发现外部 latest 只返回冲突,
不在 confirm 阶段删除(journal create intent 已提交,删除会变成无 delete
intent/receipt 的未记账副作用并让 intent 永久 held)。同 key 不自动合并。

证据:真实二进制无审计/残留审计两环境通过;kg-pgtest-writeset 一次性库 +
随机 MinIO 桶跑 14 个网关用例(含共享桶共存写者、同 key 既有对象拒绝、
精确回滚)全过;umask 022 下 make verify 本地必需项全 success。
2026-11-04 09:45:47 +08:00

44 lines
1.9 KiB
Go

package objectgateway
import "context"
// sendCreate performs exactly one non-retried versioned PUT and then confirms
// the result. Versioned object stores do not provide atomic create-if-absent,
// so the confirmation re-reads the current version to make sure this request's
// version is still the one a reader would observe.
func sendCreate(ctx context.Context, b Backend, r Request, body []byte) (Version, error) {
v, err := b.Put(ctx, r.Key, body, r.token())
if err != nil {
// Unknown outcome: the intent stays unresolved, nothing is retried and
// nothing is deleted because no version id is confirmed.
return Version{}, ErrHeld
}
return confirmCreate(ctx, b, r, v)
}
// confirmCreate binds the receipt to a version that is both the exact version
// this request wrote and the current version of the key. It is read-only: the
// create intent is already committed, so withdrawing a version here would be an
// unrecorded mutation with no delete intent or receipt and would leave the
// create intent permanently held. A concurrent writer that produced a newer
// current version therefore wins by explicit conflict; both versions stay in
// the store and an operator resolves the key with evidence.
func confirmCreate(ctx context.Context, b Backend, r Request, v Version) (Version, error) {
exact, exists, err := b.Observe(ctx, r.Key, v.ID)
if err != nil || !exists || !r.matches(exact) || v != exact {
return Version{}, ErrHeld
}
latest, current, err := b.Observe(ctx, r.Key, "")
if err != nil || !current {
// Cannot tell whether our write is still current: keep the intent held
// rather than mutating anything on a guess.
return Version{}, ErrHeld
}
if latest.ID != v.ID {
// Another writer owns the current version. Report the conflict and leave
// both versions untouched; this path never merges them automatically.
return Version{}, ErrConflict
}
return v, nil
}