返回文章列表

综述 / 资料、论文与方法的整理分析

什么是 OBS 桶?从测试角度看文件上传与下载

从测试视角认识 OBS 桶,通过 HTTP 示例理解文件上传、下载、权限校验和短期签名链接,并梳理常见测试关注点。

上传接口返回成功,不等于用户一定能下载到正确的文件。文件可能存到了错误的位置,下载权限也可能没有隔离好。

对于测试人员,理解 OBS 的重点不是先学会配置云平台,而是看清文件经过哪些环节,以及每个环节可能出现什么问题。

本文以华为云 OBS 为背景,使用一套虚构的业务接口讲解。所有请求、响应和测试场景均为示意,未调用真实云服务;接口路径、字段和状态码不是 OBS 的固定规范。

什么是 OBS 桶?

OBS(对象存储服务)用于存储和访问文件等对象。桶是存放对象的容器;一个对象除了文件内容,还可以包含对象键和元数据。可以把桶想成一个存放文件的仓库,但对象键不是传统文件系统的真实目录路径。

例如,系统将一份合同放入私有桶,相关标识可能是:

名称示例用途
桶(Bucket)contract-test存放对象的容器,本文假设它是私有桶
对象键(Object Key)contracts/2026/abc123.pdf文件在桶中的标识
业务文件 IDfile-001业务系统中用于查询文件记录的标识

对象键看起来像文件路径,但它是对象的键;业务文件 ID 则属于自己的系统。私有桶中的对象通常需要经过授权才能访问。测试时要区分业务系统的权限和 OBS 侧的访问权限,不能只看页面上有没有下载按钮。

上传:前端先把文件交给业务后端

假设用户上传一份名为「合同.pdf」的文件,前端向业务后端发起请求:

POST https://api.example.com/api/files HTTP/1.1
Authorization: Bearer <业务登录令牌>
Content-Type: multipart/form-data; boundary=example-boundary

--example-boundary
Content-Disposition: form-data; name="file"; filename="合同.pdf"
Content-Type: application/pdf

<PDF 文件二进制内容>
--example-boundary--

这里的 file 是示例业务接口约定的表单字段,Bearer 后面是业务系统的登录令牌,不是 OBS 的 AK/SK。实际使用浏览器的 FormData 时,通常应让浏览器自动生成包含 boundary 的 Content-Type。

业务后端收到文件后,先校验用户和上传权限,再把文件上传到私有桶 contract-test,对象键设为 contracts/2026/abc123.pdf。后端将文件 ID、原始名称、桶名和对象键等信息记录到数据库,供后续查询。

成功后的业务响应示例:

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "file-001",
  "originalName": "合同.pdf"
}

这里的 id 和 originalName 是业务接口自行定义的字段,不是 OBS 的固定响应。

下载:先鉴权,再获取短期链接

需要下载时,前端使用上传时拿到的文件 ID 请求业务后端:

GET https://api.example.com/api/files/file-001/download HTTP/1.1
Authorization: Bearer <业务登录令牌>

后端根据 file-001 查询数据库,确认文件位置并校验当前用户的访问权限。校验通过后,后端使用 OBS SDK 生成短期签名 URL,返回给前端:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "downloadUrl": "<OBS SDK 生成的短期签名 URL>"
}

浏览器再向签名 URL 发起 GET 请求,由 OBS 返回 PDF。示例中的尖括号只是占位说明,不是可运行的地址。

签名 URL 本身就是有效期内的临时访问凭证。拿到它的人可能在有效期内访问文件,因此不要公开分享,也不要把完整链接写入公开日志。

从测试角度,需要关注什么?

以下是一份可按项目裁剪的检查清单。先向研发确认文件限制、权限模型、保存策略和接口约定,再确定每项的预期结果。

1. 上传:能否保存正确的文件

场景检查重点
正常文件接口返回符合约定,文件记录可查询,下载后与原文件一致;必要时比较文件哈希
类型和大小覆盖允许与不允许的类型、大小边界及超限文件;不要只相信文件扩展名
特殊文件空文件、中文和特殊字符文件名、相同文件名重复上传,结果符合业务规则
异常中断上传中断或存储失败时,不应向用户报告成功;按设计检查残留对象和文件记录

重复上传究竟生成新文件还是覆盖旧文件,应以产品规则为准。测试时不仅检查返回值,也要确认后续下载的是预期版本。

2. 下载:能否拿到完整、正确的内容

  • 下载刚上传的文件,核对文件内容、大小、名称,以及浏览器能否正常打开;必要时比较上传前后的哈希。
  • 请求不存在或已删除的文件,检查响应与错误提示是否符合接口约定。
  • 按业务需求检查较大文件、下载中断和重新下载;如果系统支持断点续传,再验证相应行为。
  • 留意文件记录仍在但对象不可用等异常:系统应给出可识别的失败结果,不应把错误页面当成文件下载成功。

3. 权限:谁能上传,谁能下载

准备至少两个不同权限或不同归属的测试账号,分别上传文件,再交叉请求对方的文件 ID。检查业务后端是否逐次校验访问权限,而不是仅依赖前端隐藏按钮。

在本文的虚构接口中,可以约定未登录返回 401、无权访问返回 403、文件不存在返回 404。实际项目也可能出于避免泄露文件存在性等原因采用不同约定,应以其接口和安全策略为准。

同时确认私有桶对象不能通过未授权的普通地址直接访问;这些检查应在授权的测试环境中进行。

4. 签名 URL:临时链接是否真的有边界

  • 在有效期内访问链接,确认能够下载对应文件;过期后再次访问,确认无法继续使用。
  • 修改对象路径、请求方法等签名相关内容,确认不能借此访问其他对象;具体表现取决于签名方式和服务配置。
  • 重新申请链接时,确认业务后端仍会校验当前用户权限。
  • 检查页面、日志和分享渠道是否意外暴露完整签名 URL。它在有效期内通常可被持有者使用,业务退出登录不一定会立即使已签发链接失效。

5. 删除与一致性:记录和对象是否对得上

文件删除后,检查业务列表、文件记录和实际下载行为是否符合约定。系统可能采用软删除、延迟清理或保留策略,因此不要直接假设数据库记录和 OBS 对象必须立即同时消失。

在有权限的测试环境中,结合日志或存储管理工具检查失败场景:例如上传对象成功但保存记录失败时,系统如何处理残留对象。是否自动清理、何时清理,以项目设计为准。

出问题时,怎么定位?

先确认问题发生在哪一步:上传接口未成功,重点看业务校验和后端调用;业务接口返回了下载地址但访问失败,检查对象位置、签名有效期及存储侧权限;文件能下载但内容不对,再核对文件 ID、对象键和下载内容。

排查时记录时间、业务文件 ID、接口状态码和脱敏后的错误信息。不要在缺陷报告中粘贴完整签名 URL、真实合同或密钥。

本文采用后端中转上传:前端提交文件,后端操作 OBS 并记录位置;下载时后端鉴权并返回短期链接。实际项目也可能采用前端签名直传,测试时需要根据真实链路调整关注点。

测试 OBS 文件功能,关键是把文件内容、业务权限、存储访问和记录一致性串起来验证,而不是只看一次接口是否返回成功。

本文是“肖恩的博客”系列文章之一,首发于 seanwalter.top。作者是一名从软件测试转型AI领域的开发者,记录在转型过程中的真实思考。

版权与声明

本站所有内容仅代表作者个人观点,与作者供职的公司、客户或其他关联机构无关。

本文除特别声明外,采用 CC BY-NC-SA 4.0 许可协议。转载或改编请署名、附原文与许可证链接,并标明改动;不得用于商业用途,演绎作品须以相同许可发布。

评论