Java项目对接阿里云OSS实现文件上传的核心是直接流式上传MultipartFile到Bucket，避免本地中转；需预先配置Bucket、RAM子账号权限及AccessKey（禁硬编码），通过OSS SDK构建客户端，生成唯一ObjectKey并设置ContentType，调用putObject完成上传，返回可访问URL。
Java 项目中实现文件上传并对接阿里云 OSS，核心是把用户上传的文件（如 MultipartFile）转存到 OSS Bucket 中，而不是存到本地磁盘。关键在于不走本地中转、避免 IO 冗余，直接流式上传或内存上传，兼顾性能与安全性。
准备 OSS 基础资源
在编码前必须完成三项配置：
- 登录OSS 控制台，创建一个 Bucket，记下名称（如
my-app-bucket）和地域（如oss-cn-shanghai） - 前往RAM 访问控制台，新建子账号并授予
AliyunOSSFullAccess或最小权限策略（推荐只给oss:PutObject和oss:GetObject） - 生成 AccessKey ID 和 AccessKey Secret，并绝不硬编码在代码里；优先用环境变量（
OSS_ACCESS_KEY_ID/OSS_ACCESS_KEY_SECRET）或 Spring Boot 的application.yml加密配置
引入依赖与初始化客户端
Maven 中添加官方 SDK（建议使用 3.17.x+ 版本，兼容 JDK 17+）：
<dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>3.17.4</version> </dependency>
Spring Boot 项目中推荐封装为 @Configuration 类，自动注入配置项：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
-
endpoint：按 Bucket 地域填写，例如https://oss-cn-shanghai.aliyuncs.com -
bucket-name：你的 Bucket 名称 -
file-path：可选前缀，如uploads/或images/2026/08/，便于分类管理
上传逻辑：MultipartFile → OSS 流式直传
不要先保存到 transferTo(tempFile) 再读取上传——这会多一次磁盘 IO。应直接利用 MultipartFile.getInputStream() 构造 PutObjectRequest：
- 生成唯一 ObjectKey（如
uploads/+UUID.randomUUID()+ 原扩展名），避免覆盖和中文乱码 - 设置 ContentType（从
MultipartFile.getContentType()获取，对图片/视频很重要） - 调用
ossClient.putObject(bucketName, objectKey, inputStream)完成上传 - 返回可公开访问的 URL：
https://{bucket}.{endpoint}/{objectKey}（需 Bucket 设置为“公共读”或搭配签名 URL）
生产环境注意事项
上线前务必检查这几项：
- Bucket 的“阻止公共访问”开关是否关闭；若需私有访问，改用
generatePresignedUrl生成带时效的临时链接 - 上传路径建议加时间目录（如
images/$(year)/$(month)/），防止单目录文件过多影响性能 - 大文件（>100MB）应启用分片上传（
initiateMultipartUpload），而非简单上传 - 日志记录上传结果（成功/失败/ObjectKey/大小），便于审计和排查
