P2P 与分布式存储 / 系统课时
Pin 成功却拿不到内容怎么办
Pin 成功却拿不到内容怎么办
Pin 显示成功,用户却拿不到内容,需要判断问题发生在本地完整性还是远端发现与传输。本节沿读取路径逐层定位,避免反复 Pin 已完整数据,却始终没有处理节点下线或网络出口故障。
学习目标
- 区分本地缺块、内容类型错误和网络不可达。
- 让每个成功结果只支持对应层级的结论。
先检查保留声明对应的实际仓库
先核对 Pin 回执是本地节点还是远端服务,目标根与业务版本是否一致。远端 pinned 不能用本地清单验证,本地 recursive 也不能保证服务此刻在线。使用文件根与目录根的读取方式不同,目录根直接 cat 报错不代表目录块丢失。
若本地清单与目标一致,进行离线完整读取。失败时调查缺块、权限、校验和编解码;成功时保存内容比对证据,再进入在线服务检查。这样可以把网络补齐从本地验证中排除,而不是在线读成功后假设本仓库完整。

保留一份离线读取证据
以下 Bash 片段依赖 Kubo 0.43.1、已正常停止 daemon 的专用练习仓库、真实文件根和可信原件;均须替换。本节未真实运行节点。若目前在线,应先安排练习停机,再执行,不要直接访问仍被占用的仓库。
bash
set -euo pipefail
export IPFS_PATH='/absolute/path/to/practice-repo'
cid='REPLACE_WITH_REAL_FILE_CID'
original='/absolute/path/to/trusted-original.txt'
audit="$(mktemp -d)"
ipfs --offline pin ls --type=recursive "$cid" > "$audit/pin.txt"
ipfs --offline pin verify --verbose > "$audit/verify.txt"
ipfs --offline cat "$cid" > "$audit/local.txt"
cmp "$original" "$audit/local.txt"
printf 'local full read passed\n'预期输出:
text
local full read passed报告必须有目标 recursive 与 ok,任何 broken、error 或缺失目标都阻断通过。若在线能读而离线不能读,说明本地缺口可能被其他来源补齐,应先修复本地保留;如果原件比对失败,还要查业务版本或可信摘要是否错误。
远端服务若只返回任务接受记录,应继续查所有状态并等待明确结果。failed 要保存服务原因,queued 不代表缺块已经完成保存;这些状态不能统一转换为本地数据损坏。
本地通过后检查服务路径
按自己的节奏,确认真正理解。