在 Vue 项目中上传图片或附件,可以让文件先经过业务服务器,再由服务器转存到阿里云 OSS。不过文件较多或体积较大时,服务器也要承担相应的带宽和处理压力。常见的替代方案是由 Vue 前端直传 OSS,后端负责签发短时有效、权限受限的 STS 临时凭证。
下面以图片上传为例,说明 Vue 阿里云上传需要准备什么、怎样显示上传进度,以及上线前容易漏掉的权限和安全检查。
一、前端直传,密钥不能写进 Vue
前端直传不代表把阿里云账号密钥交给浏览器。页面代码和网络请求都可能被查看,AccessKey ID 和 AccessKey Secret 一旦写进 Vue 项目,即使放在环境变量里,也可能随构建产物暴露。
更稳妥的流程是:用户选择文件后,Vue 向业务后端申请临时凭证;后端完成身份校验并签发受限凭证;前端拿到凭证后上传文件到 OSS;上传成功,再把对象名或文件地址提交给业务接口保存。文件本身不经过业务服务器,后端也不必接收每次上传的文件流。
二、准备 OSS 和 STS 临时凭证
开发前先确认 OSS Bucket、地域和存储类型。若网页域名与 OSS 域名不同,还要在 Bucket 跨域规则中配置允许的来源域名、请求方法和必要请求头。正式环境应填写实际使用的域名,不要为了省事将来源设为任意域名。
后端需要通过 RAM 角色或其他安全方式获取签发临时凭证的能力。授权策略应限制到具体 Bucket 和业务目录,例如只允许写入指定目录,不要附带删除文件、列举整个 Bucket 等无关权限。接口通常会向前端返回临时 AccessKey、Secret、SecurityToken,以及地域、Bucket 和过期时间等信息。
申请凭证的接口也要检查登录状态和用户身份,并根据业务需要增加频率限制。前端传来的目录或文件名不能直接决定授权范围;写入范围应由后端校验。
三、Vue 3 上传示例:用回调更新进度
示例使用阿里云 OSS JavaScript SDK。安装依赖后,页面先请求 /api/oss/sts 获取临时凭证,再调用 SDK 上传。这里假设接口返回的字段与代码一致,实际项目要按后端接口约定调整。
安装依赖:npm install ali-oss
以下代码省略了样式和请求封装。接入项目时,建议使用统一的请求工具,并检查接口返回的数据是否完整。
import OSS from ‘ali-oss’
import { ref } from ‘vue’
const progress = ref(0)
const imageUrl = ref(”)
const uploading = ref(false)
async function uploadImage(file) {
if (!file || !file.type.startsWith(‘image/’)) {
throw new Error(‘请选择图片文件’)
}
const result = await fetch(‘/api/oss/sts’, { credentials: ‘include’ })
if (!result.ok) throw new Error(‘获取上传凭证失败’)
const auth = await result.json()
const client = new OSS({
region: auth.region,
bucket: auth.bucket,
accessKeyId: auth.accessKeyId,
accessKeySecret: auth.accessKeySecret,
stsToken: auth.securityToken
})
const safeName = file.name.replace(/[^\w.-]/g, ‘_’)
const objectName = `uploads/${Date.now()}-${safeName}`
uploading.value = true
try {
const res = await client.put(objectName, file, {
progress: (value) => { progress.value = Math.round(value * 100) }
})
imageUrl.value = res.url
return { objectName, url: res.url }
} finally {
uploading.value = false
}
}
progress 是 0 到 100 的百分比,可以绑定到进度条或文字提示;上传过程中用 uploading 禁用重复提交。生产环境还要捕获异常并显示清楚的提示。临时凭证和完整错误堆栈不应输出到面向用户的页面。
四、商品后台上传主图的处理方式
例如,运营人员在商品后台上传主图。前端可以先限制 JPEG、PNG、WebP 等格式,并设置单张大小上限,例如 5MB;后端再根据当前用户身份签发短时凭证,只允许写入 products/ 目录。上传成功后,前端把对象名提交给商品保存接口。
业务数据库通常保存对象名会更灵活。以后更换 CDN 域名或调整访问策略时,不必逐条改写完整访问地址。图片需要公开展示时,可以通过合适的 Bucket 访问策略或 CDN 域名提供访问;合同、用户资料等私密文件则应保持私有,由后端按需生成短时签名地址。上传权限和读取权限要分别设计。
五、常见问题与排查方法
- 浏览器提示跨域错误:检查 OSS 跨域规则是否包含当前页面域名、实际使用的请求方法(如 PUT)和 SDK 所需请求头,也要确认预检请求没有被网关或代理拦截。
- 上传返回 403:核对 STS 是否过期、SecurityToken 是否传入、地域和 Bucket 是否对应,并检查 RAM 策略是否允许写入目标目录。不要只因报错就直接扩大授权范围。
- 大文件上传慢或中断:普通 put 适合常见小文件。较大的文件可以评估 SDK 的分片上传,并提前设计失败重试、取消上传和未完成分片清理。
- 对象名或路径不安全:不要直接把用户输入拼成对象路径。可以由后端生成随机文件名或目录,并校验扩展名、文件大小和内容类型。浏览器提供的 MIME 类型不能单独作为安全依据。
- 需要写入不同目录:由后端根据用户身份和业务类型决定可写范围。前端提交的目录参数必须经过校验,不能让客户端借此扩大授权。
六、上线前检查这些环节
部署前,分别测试凭证过期后能否重新申请、未登录用户能否被拒绝、上传失败后界面能否恢复,以及对象是否进入预期目录。还要确认敏感文件没有被意外公开。图片业务可根据需要增加服务端内容检测、压缩或审核流程。
这套方案的职责分工比较清楚:Vue 负责文件选择、上传交互和进度反馈;后端校验身份并控制 STS 授权范围;OSS 保存文件。把这几处权限和异常处理落实好,前端直传才能既方便使用,也不把密钥和文件访问权限留在浏览器里。