2025年若依文件上传接口（文件上传接口文档怎么写）

欢迎使用 Amazon Web Services 文档 (amazonaws.cn) icon-default.png?t=N7T8 https://docs.amazonaws.cn/zh_cn/?nc2=h_l2_su找到 Amazon S3

Amazon S3 是云存储标杆，可以支持所有接入 S3的云存储写一

客户端配置

从Amazon S3迁移到OSS后，您仍然可以使用S3 API访问OSS，仅需要对S3的客户端应用进行如下改动：

获取阿里云账号或RAM用户的AccessKey ID和AccessKey Secret，并在您使用的客户端和SDK中配置您申请的AccessKey ID与AccessKey Secret。

二、配置

ruoyi-oss 模块引入依赖

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
</dependency>

模块解析：

com.ruoyi.oss.constant.OssConstant ：对象存储常量配置（引入云服务商如下：阿里腾讯七牛云华为）
com.ruoyi.oss.core.OssClient：S3 存储协议所有兼容S3协议的云厂商均支持,（）
com.ruoyi.oss.enumd.AccessPolicyType 桶的访问策略配置
com.ruoyi.oss.enumd.PolicyType ：文件读写策略
com.ruoyi.oss.factory.OssFactory：文件上传工厂，用于获取OssClient 实例
com.ruoyi.oss.entity.UploadResult 返回结果类
com.ruoyi.oss.properties.OssProperties OSS对象存储配置属性

类位置： com.ruoyi.oss.core.OssClient

作用; 创建 AmazonS3 上传文件客户端（代码已经上传附件）

sys_oss_config 配置表对应的字段

1-使用：

上传：只需要调用 OssClient 的上传方法（如下，提供字节路径等参数）

删除：提供全路径

uploadSuffix  ：提供字节（或者输入流） 上传文件

getObjectMetadata ： 根据完整文件路径，获取文件元数据

2- OssFactory 客户端工厂

OssClient  实例工厂。提供 有参 和 无参构造2种方式获取客户端
类位置： com.ruoyi.oss.factory.OssFactory

实现了 ApplicationRunner 方法，项目启动后回去执行初始化配置

类位置：com.ruoyi.system.service.impl.SysOssConfigServiceImpl

上传初始化操作：

加载配置到缓存中，并设置默认值

类位置： com.ruoyi.web.controller.system.SysOssController

1-上传按钮：

路径：srcviewssystemossindex.vue

2-上传对话框：

3-定义上传文件组件 fileUpload ：

路径： srccomponentsFileUploadindex.vue

实现技术：

el-upload 实现该上传属性，具体api查看element官网

路径： ruoyi-admin/src/main/resources/application.yml

后端上传文件配置：

4-组件设置为全局组件：

路径：srcmain.js

Vue.component('FileUpload', FileUpload)

六、图片上传组件

路径 : srccomponentsImageUploadindex.vue

功能：对比上面上传文件，只是多了回显功能，其他一样

1-先开启阿里云配置

2- 阿里云空控制台搜索oss 服务

3- 右上角进入 accesskey管理

创建用户，并验证。最后配置到系统

使用子账户 key（主账户key泄露比较危险，子账户随时可以关闭）

创建用户，开启api调用。之后手机短信验证

这里复制 key，

保存上面key

4-创建桶

5-配置上面桶的信息

上传文件报错; 提示没有权限 you have not right access

accesskey管理中设置权限

再次测试上传：成功

绑定域名后就可以用自己的域名来访问图片。

注意：

要在自己域名网站配置CNAME

如果配置https，可以去宝塔或者腾讯登申请免费证书陪配置（否则访问不到文件）

绑定域名配置在 自定义域名

步骤同上面七：阿里云配置一样。腾讯云点击左上角搜索对象存储

唯一不同的注意点：

上传提示错误：Access Denied. (Service Amazon s3: Status 403 ；Error code :Access Denied。。。

是域一定要配置，阿里云则默认可以为空

1-开启七牛云配置

2-找到对象存储

3-新建桶：（七牛有效期30天）

4-基础配置中查看s3域名，复制里面的 Endpoint，到若依文件配置的访问站点。空间授权（只读和读写看下）

5- 测试域名设置为我们的 自定义域名（七牛云免费自带）

6-右上角秘钥管理设置我们的 AccessKey/SecretKey

测试上传成功