上传按钮在本地能用,不代表上线后就稳妥。图片、附件和视频可能遇到文件过大、网络中断、权限不足等问题;如果文件先经过业务服务器,还会占用服务器带宽和处理资源。接入前先理清上传链路:WebUploader负责浏览器端的文件选择、进度和上传交互,阿里云OSS负责存储文件。两者之间还需要业务后端处理授权、上传确认和文件记录。
先确定文件经过哪条上传链路
常见做法有两种:浏览器把文件传给业务服务器,由服务器再转存OSS;或者浏览器向后端申请临时授权,再直接上传到OSS。前一种更容易沿用已有接口,也方便在文件入库前执行复杂检查,但文件会经过业务服务器,上传量大或文件较大时,带宽和资源开销也会增加。
直传OSS可以减少业务服务器的传输负担,适合图片数量较多或文件较大的场景。后端仍然要参与:它需要验证用户身份和上传权限,签发短期凭证,并在上传完成后确认对象状态、保存业务记录。不要把“浏览器能直接上传”理解成可以绕过后端。
接入时需要走通的步骤
- 配置WebUploader。设置文件类型、大小限制、上传并发数和事件处理,覆盖文件加入、上传进度、成功、失败及取消等情况。前端校验主要是改善使用体验,不能代替服务端校验,用户可以绕过页面直接构造请求。
- 由后端签发临时授权。前端先请求业务接口,后端确认用户有上传权限后,再通过阿里云STS等机制发放短期凭证。权限范围应限制在需要的Bucket和对象路径,避免凭证被拿去操作无关资源。
- 按选定的OSS方式上传。前端取得凭证和目标对象Key后,向正确的OSS区域及Bucket发送文件。对象Key最好由后端或可靠的业务逻辑生成,不要直接把用户提供的原始文件名当作存储路径。
- 上传后由后端确认并登记。前端将对象Key、文件大小等信息提交给业务接口,后端检查OSS中的对象确实存在,再保存文件与业务数据的关联。仅凭浏览器收到成功响应,不足以证明文件已经可靠入库。
WebUploader的配置和OSS接口并非直接对应。普通表单上传、OSS签名上传和OSS分片上传的请求参数、签名及完成步骤可能不同,不能只把OSS域名填进WebUploader的server字段就认为接入完成。应先确定具体上传方式,再逐项处理签名、请求头、跨域规则以及上传完成后的回调。
案例:后台商品图片直接上传OSS
假设电商后台每天要上传大量商品图片。原来图片先传到应用服务器,再由服务器转存OSS;高峰期上传请求占用应用带宽,较大的图片也更容易遇到超时。调整后,WebUploader继续负责选择图片、展示进度和提示文件要求。用户选好图片后,前端向后端申请短期凭证和对象Key,再把文件直接传到OSS。上传结束后,后端检查对象并记录商品与图片的关联。
这类改造中,长期访问密钥不能写进网页代码。服务端应使用云账号凭证签发临时授权,并限制有效时间和可写入目录。对象Key使用随机标识,原文件名可以作为展示信息单独保存。这样既减少应用服务器承担的文件传输,也能避免访客从网页源码中拿到长期密钥。
分片上传和断点续传要单独验证
WebUploader支持分片相关功能,但开启分片不等于已经完成OSS原生分片上传。OSS分片流程通常需要初始化上传任务、逐片上传,最后提交合并结果,同时维护上传ID和分片编号。若业务要求大文件断点续传,应先明确分片状态由哪一端管理,再按OSS接口实现完整流程;也可以评估阿里云官方SDK或其他仍在维护的上传方案。
普通上传也要处理进度、失败原因和重试入口。网络中断后,不要不加判断地反复创建同名对象:可以使用唯一对象Key,并明确重试时是查询已有状态、继续上传还是覆盖对象。大文件场景还要测试分片大小、并发数和超时设置,避免并发过高导致浏览器内存占用增加。
上线前检查安全与配置
- 核对跨域规则:在OSS控制台按实际网页域名配置CORS,并明确允许的方法和请求头。开发环境与生产环境可以分别设置,生产配置不要为了省事使用过宽的通配规则。
- 限制凭证权限:不要在前端放置AccessKey或长期密钥。临时凭证只授予上传所需权限,并限制Bucket、对象路径和有效时间。
- 校验文件内容:检查扩展名、大小和实际文件类型;有需要时增加病毒扫描或内容审核。文件名及浏览器提交的MIME类型都不能单独作为可信依据。
- 确认访问方式:根据业务选择私有读或公共读。私有文件应通过后端鉴权或短期签名URL访问,不要因为上传流程简单就默认把文件设为公开。
- 处理异常与清理:覆盖凭证过期、网络超时、用户取消和回调失败等情况。若使用分片上传,还应为未完成的分片任务设置清理方式;没有业务记录的对象也要纳入清理检查。
根据文件规模选择实现方式
文件较小、上传量有限,并且已有稳定的后端上传接口时,服务器中转通常开发成本更低。上传量大、文件较大或应用服务器带宽紧张时,可以考虑后端签发临时授权、浏览器直传OSS。若业务依赖可靠的断点续传或复杂分片管理,也要评估WebUploader当前版本和项目技术栈是否适合继续维护;不要只为沿用旧组件而忽略接口适配成本。
测试时可以先用小文件跑通授权、上传和后端登记,再分别验证大文件、断网重试、凭证过期及无权限用户的处理结果。最后检查对象是否按预期读写、失败任务是否能清理。这样比只确认一次上传成功更有用,也能尽早发现正式环境中的配置问题。