文档中心

对象存储

校验数据一致性

概述

概述

使用 TOS 进行数据上传或下载的过程中，可能会因为公网传输过程中在 TOS 外部的网络劫持、数据缓存等原因，导致数据不一致等问题。为确保数据完整性，TOS 提供了上传/下载对象一致性校验两种方案。本文将介绍这两种校验场景下的相关概念。

相关概念

Content-MD5

HTTP 协议定义的标准请求头域，代表请求消息体数据的指纹值，其计算方式是将数据经过 MD5 算法计算出哈希值后再经过 Base64 编码生成字符串。

在 TOS 场景中，PutObject 和 UploadPart 接口支持在请求头域中携带该参数，PostObject 支持在表单域中携带该参数。TOS 会以同样的算法计算收到的数据并与该值做比较，如果不匹配则返回上传失败，对象不会在 TOS 侧生成。

Content-SHA256

TOS 场景定义的请求头域，与 Content-MD5 类似，同样代表请求消息体数据的指纹值，只是其计算方式使用了更安全的 SHA256 算法，将数据经过SHA256 算法计算出哈希值后再经过 Hex 编码生成字符串。

PutObject 和 UploadPart 接口支持在请求头域中通过 x-tos-content-sha256 携带该参数。

CRC64

循环冗余校验算法，是常用于数据校验的标准算法，详细信息，请参见 Cyclic redundancy check。

在 TOS 场景，PutObject、PostObject、UploadPart、GetObject、HeadObject、CompleteMutipartUpload 均会在响应头域中通过 x-tos-hash-crc64ecma 字段返回该参数，代表本次读写数据的 CRC64 校验和。

注意

CRC64 是新特性，部分该特性上线前上传的对象，GetObject 和 HeadObject 的响应头域中可能不包含 CRC64。

GetObject 携带 Range 参数时，响应头域中返回的 CRC64 仍然是整个对象的 CRC64。

ListObjects 和 ListObjectVersions 获取到的对象列表中也新增了代表每个对象 CRC64 的字段。

最近更新时间：2026.07.29 11:21:38

这个页面对您有帮助吗？

有用

有用

无用

无用