P2P 与分布式存储 / 系统课时
如何区分本地故障与网络故障
如何区分本地故障与网络故障
本地节点、远端副本和公共网关给出不同结果时,需要先分清每项检查经过了哪些路径。本节建立交叉验证矩阵,把存储故障与发现、连接或出口故障区分开,避免错误地宣布内容丢失。
学习目标
- 用独立来源与受控读取定位故障范围。
- 正确解释网关成功、失败和缓存命中。
先取得本地离线证据
目标仓库停机后的离线完整读取,是本地数据完整性的强证据之一;还应核对可信摘要和 Pin 关系。在线读取可能从网络补齐缺块,所以不能作为本地完整性的替代。受控远端副本也需要单独离线恢复,而不是互相联网修补后一起通过。
再从新请求方测试在线服务,记录节点身份、连接路径、根与完整传输结果。公共网关是另一个出口,可能缓存内容、执行限流或拒绝某些路径;把它作为对照可以缩小范围,但不能把单个结果当成所有存储节点的事实。
用已取得的证据分类
下面 Node.js 程序只分类输入观测,不连接 IPFS,也不探测网关。保存为 classify.cjs 并运行 node classify.cjs。online 表示受控请求方的完整读取结果,不是任意网页打开成功。
function classify(e) {
// 本地完整性与远端入口不同,顺序先判断本地证据。
if (!e.localOffline) return e.online ? 'local gap masked by network' : 'local failure; remote unknown';
if (!e.online) return 'local intact; inspect discovery or transport';
if (!e.gateway) return 'controlled path works; gateway-specific issue';
return 'tested paths work at observation time';
}
const evidence = [
{localOffline: false, online: true, gateway: true},
{localOffline: true, online: false, gateway: false},
{localOffline: true, online: true, gateway: false}
];
for (const item of evidence) console.log(classify(item));预期输出:
local gap masked by network
local intact; inspect discovery or transport
controlled path works; gateway-specific issue这些分类仍需要真实日志和内容比对才能形成诊断。输入 false 代表已执行并失败,未知或未执行不应伪装成 false;实际报告应额外标记未检查,避免把未验证的副本直接判为坏副本。

对照实验避免共享缓存
两个出口都成功,可能都依赖同一个上游节点;多个网关也可能有共同后端。想证明独立副本,必须控制来源并检查实际仓库,不能只换域名。测试请求方应从新仓库开始,读取到结束,并比较业务内容。
网络失败时先查节点在线状态和可达地址,再查路由发现与连接传输,避免一上来改 Pin 规则。本地失败时先查仓库路径、权限、块完整性和根类型;目录与文件读取方式混用需要先纠正,不能归因于公网异常。
对敏感内容,应使用授权的私有读取路径,不因排障而把秘密 CID 或数据提交到公共服务。记录查询时间、错误阶段与版本,有助于判断短时失败与重复故障。真实节点和网关测试本节未执行。
若两个检查时间相隔很久,结果差异可能来自节点状态变化,而不是出口差异。对照时尽量固定时间窗口与目标版本,记录中途发生的维护和发布。
练习为每一行分类补一个下一检查项,并指出哪项观测仍未知。依据见官方排障说明和内容路由说明,分类程序是整理证据的工具,不是凭空产生证据的工具。