适用范围与准备
适用于WebDAV目录查询或批量操作收到207 Multi-Status,但部分文件或属性没有达到预期。先保留本地文件和完整响应副本;不要看到2xx就删除唯一源文件。
先区分原因
207是包含多项结果的响应外壳,内部可以同时出现成功和失败。WebDAV的multistatus通常包含多个response,每项用href指向资源;状态可能直接属于资源,也可能位于propstat中描述一组属性,因此不能只抽取正文里第一个200。
按顺序操作
- 记录本次方法、请求目录和响应类型。确认正文确实是WebDAV multistatus XML,而不是登录页或网关错误页;具体操作的成功条件按方法文档核对。
- 按每个response的href建立对应表,再读取status或各propstat里的状态。保持资源与属性的对应关系,不把一个文件的成功套到旁边文件。
- 把成功、失败和没有返回结果的项目分开。目录查询中的某属性404不必然表示文件不存在;写操作中的失败也不能因为其他文件成功就忽略。
- 在决定重试前核对远端现有资源和本地修改。只对确认需要重试且操作语义允许的部分继续处理,避免重复覆盖已经成功的文件。
| 观察层级 | 记录内容 |
|---|---|
| 最外层207 | 这是多项结果,需要继续读正文 |
| response/href | 本项对应哪个资源 |
| response/status | 资源级结果(若采用此结构) |
| propstat/status | 哪些属性一起成功或失败 |
| 未出现的预期项 | 标为未确认,不能自动补成成功 |
怎样确认有效
应列清实际检查了多少项、成功多少、失败多少、尚未确认多少。操作需要保存文件时,还应核对远端内容或版本;仅完成目录列举不能证明后续同步全部完成。
无效时恢复与下一步
保留未同步文件,先处理权限、目标路径或空间等具体失败原因。遇到507可转存储故障篇;不要清空同步目录来重建现场,也不要把XML解析失败伪装成“没有失败项”。