精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云oss上传时,Bucket权限和代码里常踩的3个坑

不少项目会把图片、视频和日志放到阿里云OSS上。容量可以按需扩展,计费按量,用起来省心。真正动手写阿里云oss上传的代码时,问题通常出在三个地方:Bucket权限没配对,大文件传到一半超时,浏览器直传时报跨域错误。这篇文章用一个电商商品图上传的例子,把常见的上传方式和配置细节过一遍。

阿里云oss上传时,Bucket权限和代码里常踩的3个坑

一、上传前的准备

下面三步做完,后面的代码才能顺利跑通。

  1. 创建Bucket:在OSS控制台新建Bucket,地域选离用户最近的,比如华东1(杭州)。读写权限保持私有,访问靠签名或授权来控制,不要图省事开成公共读。
  2. 创建RAM子账号:在RAM控制台新建专用子账号,只授予目标Bucket的读写权限。代码里直接用主账号的AccessKey,等于把整个账号交出去,一旦泄露,影响范围很难收住。
  3. 记下Endpoint:格式通常是 https://oss-cn-hangzhou.aliyuncs.com。后面的所有配置都要和Bucket所在的地域对得上。

二、五种常见的上传方式

1. 控制台手动上传

适合临时传几个文件,比如补一批素材或者排查问题。进入Bucket的文件管理页面点击上传即可。文件较大时,控制台会自动切换为分片上传,不需要额外设置。

2. 使用Python SDK简单上传

后端服务最常见的写法。下面的例子使用官方的oss2库,AccessKey从环境变量读取,代码里不留明文:

import os
import oss2

auth = oss2.Auth(os.environ['OSS_ACCESS_KEY_ID'],
                 os.environ['OSS_ACCESS_KEY_SECRET'])
bucket = oss2.Bucket(auth,
                     'https://oss-cn-hangzhou.aliyuncs.com',
                     'your-bucket-name')

# 上传本地文件,第一个参数为OSS中的对象路径
result = bucket.put_object_from_file('products/1001/main.jpg',
                                     'local/main.jpg')
print(result.status)  # 返回200表示成功

第一个参数是OSS中的对象路径,第二个是本地文件路径。像 products/1001/ 这样的前缀并不会真的创建目录,它只是对象名的一部分,控制台会按前缀把它显示成文件夹。返回状态码200即表示成功。

3. 大文件分片断点续传

单次PUT请求的上限是5GB,超过这个大小就该用分片。oss2提供的resumable_upload会自动切片,网络中断后从已完成的分片继续,视频和备份包这类大文件用它最省心。分片大小一般在1MB到10MB之间。太小,请求次数多,整体反而慢;太大,一片失败就得整片重传。另外,分片数上限是10000个,分片大小要和文件大小一起算,别让大文件撞到这个上限。

4. 前端直传(预签名URL)

让浏览器直接把文件传到OSS,应用服务器只负责签发一个有时效的预签名URL,不再经手文件内容。前端拿到URL后用PUT方法上传即可。示例中的商品图上传就是这样改的,服务器带宽占用下降了七成以上。

5. 使用STS临时凭证

上传端是移动App或第三方客户端时,不要下发长期有效的AccessKey。一旦客户端被反编译或者凭证泄露,风险很大。改用STS获取有效期约一小时的临时凭证,再把权限限制在具体的路径前缀上,泄露后的影响会小很多。

三、一个真实案例的复盘

某中型电商团队最初用的是方式二,商品图全部经由应用服务器中转。大促期间,服务器出口带宽被打满,上传接口的平均响应时间从300毫秒涨到4秒,用户看到的就是一直转圈。

后来他们把商品图改成预签名直传,上传请求不再经过业务服务器,接口响应恢复正常。视频素材则换成了分片断点续传,弱网环境下的失败率从15%降到了不足2%。直传之前,权限和跨域规则要先配好,这一步省不得。

四、三个常见的坑

  • 跨域报错:浏览器直传时,请求会先发一个OPTIONS预检。需要在Bucket的跨域设置里添加允许的来源、PUT方法和Content-Type请求头,否则预检不通过,真正的上传请求根本发不出去。本地调试时来源可以写成 http://localhost:端口,上线前再收紧为正式域名。
  • Endpoint选错地域:Bucket在杭州,代码里却填了北京的Endpoint,返回的错误往往是403或404,信息含糊,很容易被带去排查签名和权限。遇到这类报错,先核对地域,这一步最省时间。
  • 对象路径设计:所有文件堆在同一层目录,后期查找和清理都很麻烦。按业务和日期分层,比如 products/年月日/,之后配置生命周期规则时也能按前缀精准匹配。

五、怎么选上传方式

选方式的依据是文件大小、上传端和安全要求。小文件由后端直传就够用;大文件用分片续传;浏览器和移动端场景优先用预签名URL或STS临时凭证,别把长期AccessKey放到客户端。动手前把子账号权限、Endpoint和跨域规则核对一遍,大部分报错都能提前避开。

赞 (0)
阿里云yum源怎么换?CentOS服务器实操记录
上一篇 2026年10月31日 下午7:32
阿里云专有云适合哪些企业?私有化部署怎么选
下一篇 2026年10月31日 下午7:32

相关推荐

  • 阿里云售后怎么找人、工单怎么提,走一遍流程

    实例突然连不上,账单里冒出一笔看不懂的扣费,或者想升配置却不知道从哪步开始,这些事多数人都碰到过。遇到这种情况,第一反应通常是找售后。但售后到底管什么,工单怎么写才能让对方快速接手,这篇按实际操作的顺序讲一遍。 售后一般管哪些事 很多人以为售后就是出了故障才找人。实际上,常见需求大致有四类:云服务器无法登录、网络不通这类技术故障;扣费明细核对、计费方式确认、…

    2026年10月31日
  • 阿里云可视化怎么用?先搭数据大屏,再配业务看板

    阿里云可视化,简单说就是把阿里云上的数据、指标和业务状态做成图表、地图或大屏,让人一眼看懂。它是一整条链路,从数据采集、计算到展示都包括在内。团队如果没有太多开发人手,可以直接用云上托管的服务,不必自己搭服务器、维护报表系统。 先分清三类产品 选型前先想清楚用途,否则很容易用错工具。 DataV 数据可视化,偏大屏展示。组件和地图丰富,模板也多,适合会议室大…

    2026年10月31日
  • 阿里云网盘内测申请表怎么填,哪些信息容易卡住

    很多人想提前用上新功能,会先搜一圈“阿里云网盘内测申请表”。入口好找,难的是填完能不能被选上。这篇从普通用户的角度,讲讲申请时该准备什么、怎么写,哪些地方容易卡住。 内测到底是什么 内测一般是正式上线前的小范围试用。团队挑一批人先用,收集问题,再决定哪些要改。名额有限,提交了也不等于一定通过。 所以申请表更像一张用户信息卡。团队想知道你平时怎么用网盘,设备是…

    2026年11月1日
  • 阿里云实习怎么投?岗位方向和面试要点

    阿里云是国内规模较大的云计算服务商,计算、存储、数据库、大数据、人工智能和安全等业务都在其中。对在校生来说,实习的价值在于接触真实的线上系统和企业客户的实际需求,这比课堂练习更接近工作的样子。 如果你对技术有明确兴趣,能适应较快的节奏,也愿意主动问问题,这类实习会比较合适。如果只是想体验一下办公环境,或者编程和系统知识还比较薄弱,不妨先把课程内容补扎实,再去…

    2026年10月31日
  • 阿里云考试认证报名前需要准备哪些材料?

    学云计算的人迟早会问:考阿里云认证到底有没有用?它能证明什么,入门该从哪一级开始?下面用三个学习场景,把这条路理一理,方便正在犹豫的朋友对照自己的情况。 先搞清楚认证是怎么分层的 阿里云认证大致分三层:入门的助理级,偏工程实践的高级,以及面向复杂架构设计的专家级。层级越高,要求的知识深度和动手经验越多。方向也分开来,云计算基础、大数据、人工智能、安全各有各的…

    2026年10月31日
返回顶部