做头像、商品图或订单凭证上传时,常见方案是先把图片发到业务服务器,再由服务器转存到阿里云 OSS。这样接入直观,但图片要多走一段网络,服务器也会承担额外带宽和维护成本。使用 OSS Android SDK 后,图片可以从手机直接上传到 OSS,业务服务器负责校验用户身份并签发临时凭证。
这里有条安全底线:不要把 AccessKey ID 和 AccessKey Secret 放进 APK,也不要以配置文件的形式打包进去。代码混淆不能可靠保护长期密钥,攻击者仍可能从客户端提取密钥并绕过 App 调用 OSS。Android 图片上传阿里云时,应使用服务器签发的 STS 临时凭证,并限制凭证的有效期和访问范围。
先理清上传流程
一套常用流程是:用户在 App 中选图,客户端向业务服务器请求 STS 临时凭证,然后通过阿里云 OSS Android SDK 上传图片。图片直接传到 OSS,服务器不接收图片文件,只处理身份校验、权限控制和凭证签发。
- Android 客户端:负责选图、按需压缩、发起上传、展示进度,并把上传结果交给业务层。
- 业务服务器:验证用户身份,按需签发短时有效的 STS 凭证,并限制 Bucket 和对象路径。
- 阿里云 OSS:接收并保存对象,具体访问权限、生命周期和图片处理规则按业务需求配置。
例如,用户上传头像时,凭证可以只允许向 avatars/用户标识/ 路径写入对象。不要为了少配几项就给客户端整个 Bucket 的读写权限;权限范围一旦过宽,凭证被滥用时影响也会更大。
接入前要准备什么
先创建 OSS Bucket,确认地域、Bucket 名称和访问策略。服务器端还要配置 RAM 角色和 STS 服务,确保签发出来的凭证权限符合具体用途。用户上传头像和上传订单凭证,所需的对象路径及操作权限可能不同,最好分别按业务场景设置。
Android 工程按项目使用的构建方式引入 OSS Android SDK。SDK 依赖写法和接口可能随版本变化,接入时应查看阿里云官方文档中对应版本的说明。应用需要在 Manifest 中声明网络权限;如果只是从相册选择图片,可以优先考虑系统照片选择器,避免申请与功能无关的存储权限。
核心代码怎么组织
下面用 Java 展示主要调用顺序。STS 请求地址、Bucket、地域和对象路径都要换成项目自己的配置;如果所用 SDK 版本的构造方法或回调接口不同,也要按对应版本调整。示例中的 requestStsToken() 代表向业务服务器请求凭证的逻辑,不能用它在客户端生成长期密钥。
String objectKey = "avatars/" + userId + "/" + imageName;
// 从业务服务器获取临时凭证
StsTokenModel token = requestStsToken();
OSS oss = new OSSClient(
context,
endpoint,
new OSSStsTokenCredentialProvider(
token.getAccessKeyId(),
token.getAccessKeySecret(),
token.getSecurityToken()
)
);
PutObjectRequest request = new PutObjectRequest(
bucketName,
objectKey,
localImagePath
);
oss.asyncPutObject(request, new OSSCompletedCallback<PutObjectRequest,
PutObjectResult>() {
@Override
public void onSuccess(PutObjectRequest request, PutObjectResult result) {
// 将 objectKey 或业务约定的图片地址交给业务层
}
@Override
public void onFailure(PutObjectRequest request,
ClientException clientException,
ServiceException serviceException) {
// 记录必要错误信息,并提示用户重试
}
});
异步上传不会占住主线程,适合直接用于界面操作。需要展示上传进度时,接入 SDK 对应版本提供的进度回调,并把进度条更新切回主线程。上传成功后,通常将对象 key 保存到业务数据库,不要只依赖客户端临时拼出的图片 URL。以后更换域名、CDN 或访问策略时,保存 key 会更方便调整。
图片处理和文件命名别忽略
手机原图可能很大,上传前可以按用途调整尺寸和质量。头像通常不需要保留相机原图尺寸;订单凭证则要控制压缩程度,避免文字变得模糊。压缩产生的临时文件要及时清理,也要检查 EXIF 方向信息。有些设备拍摄的照片如果没有正确处理方向,上传后显示时会出现旋转错误。
对象名不要固定写成 image.jpg,否则用户再次上传时可能覆盖之前的文件。可以把随机标识或时间戳与用户目录组合起来,例如 avatars/用户ID/随机文件名.jpg。文件扩展名和 Content-Type 应与实际图片格式相符。也不要只凭扩展名判断文件内容,服务器仍应进行必要的校验。
案例:个人头像上传
以社区 App 为例,用户从相册选好头像后,客户端先生成适合展示的图片,再向服务器请求上传凭证。服务器确认用户已登录,签发短时有效的 STS 凭证,并把允许写入的路径限制在该用户的头像目录下。客户端将图片上传到 OSS,成功后再把对象 key 提交给业务接口,由服务器更新用户头像记录。
这样图片不必经过业务服务器,网络链路更短;路径限制也能避免用户把文件写到其他人的目录。上传失败时,App 应保留原头像并提示重试,等对象确实上传成功后再更新头像记录,避免界面指向一个尚不存在的文件。
上线前检查这些问题
- 凭证安全:STS 由服务器签发,设置合理的有效期和最小权限;不要把临时凭证写入日志。
- 上传权限:服务器校验登录身份和对象路径,不能让客户端随意指定其他用户的目录。
- 异常处理:区分网络错误、凭证过期和 OSS 服务端错误;凭证过期时,可重新请求凭证后再尝试上传。
- 用户体验:显示上传进度和失败状态,并在上传进行中限制重复点击,减少重复文件。
- 访问方式:私有 Bucket 不要直接暴露长期可访问的地址;可由后端签发临时访问地址,或使用受控的图片分发方案。
建议先拿一张小图片跑通“选图—请求凭证—上传—保存对象 key”这条链路,再接入压缩、进度展示和失败重试。排查时也按这几个环节逐项确认:凭证是否有效、权限是否覆盖目标路径、文件是否成功到达 OSS,以及业务记录是否在上传成功后更新。