fix(cas): exists 返回 Result 以区分不存在与存储故障

CasRepository::exists(core trait)与底层 Storage::exists 原返回裸 bool,
FileSystemStorage 用 try_exists(...).unwrap_or(false)、infra 适配层吞掉解析/
初始化错误返回 false,调用方无法区分“对象不存在”和权限/IO/初始化故障。

将整条链改为 Result<bool>:
- storage trait 与 FileSystemStorage:try_exists 的 IO 错误经 ? 传播;
- repository FileSystemCasRepository::exists 及 store/add_reference 内部调用;
- core CasRepository::exists trait;
- infra 适配层:解析失败→InvalidArgument、初始化/引擎错误经 map_error 传播。
Ok(false) 仅表示确实不存在。

新增单测:合法但不存在的对象返回 Ok(false),非法 ObjectId 返回 Err(而非静默
false);同步更新各层 exists 断言。

对应 issue #18 维护清单 2-1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-16 08:53:54 -07:00
co-authored by Claude Fable 5
parent c362fd80f4
commit 48ffc08cdf
6 changed files with 48 additions and 28 deletions
+7 -7
View File
@@ -37,7 +37,7 @@ impl FileSystemCasRepository {
/// 存储对象并增加引用计数。
pub async fn store(&self, data: &[u8]) -> Result<Hash> {
let hash = compute_hash(data);
let existed = self.storage.exists(&hash).await;
let existed = self.storage.exists(&hash).await?;
let stored_hash = self.storage.put(data).await?;
// 单条 UPSERT 原子建行并 +1:对象行不会在 store 期间以 ref_count=0
@@ -75,13 +75,13 @@ impl FileSystemCasRepository {
}
/// 检查对象是否存在。
pub async fn exists(&self, hash: &Hash) -> bool {
pub async fn exists(&self, hash: &Hash) -> Result<bool> {
self.storage.exists(hash).await
}
/// 增加引用计数。
pub async fn add_reference(&self, hash: &Hash) -> Result<u64> {
if !self.storage.exists(hash).await {
if !self.storage.exists(hash).await? {
return Err(CasError::ObjectNotFound(hash.to_string()));
}
@@ -169,8 +169,8 @@ mod tests {
repo.remove_reference(&delete).await.unwrap();
assert_eq!(repo.gc().await.unwrap(), 1);
assert!(repo.exists(&keep).await);
assert!(!repo.exists(&delete).await);
assert!(repo.exists(&keep).await.unwrap());
assert!(!repo.exists(&delete).await.unwrap());
assert!(matches!(
repo.get_reference_count(&delete).await,
Err(CasError::ObjectNotFound(_))
@@ -209,7 +209,7 @@ mod tests {
assert_eq!(repo.get_reference_count(&hash).await.unwrap(), 1);
assert!(repo.gc_candidates().await.unwrap().is_empty());
assert_eq!(repo.gc().await.unwrap(), 0);
assert!(repo.exists(&hash).await);
assert!(repo.exists(&hash).await.unwrap());
}
#[tokio::test]
@@ -224,7 +224,7 @@ mod tests {
assert_eq!(repo.add_reference(&hash).await.unwrap(), 1);
// gc 的原子闸门应跳过它,对象文件保留。
assert_eq!(repo.gc().await.unwrap(), 0);
assert!(repo.exists(&hash).await);
assert!(repo.exists(&hash).await.unwrap());
assert_eq!(repo.get_reference_count(&hash).await.unwrap(), 1);
}