uni.uploadFile用于文件上传，需了解HTTP协议和服务器配置。具体步骤：准备文件路径和名称，构造 formData（含附加参数和文件类型）。设置请求头为 multipart/form-data。处理大文件时使用进度监听和断点续传（需服务器配合）。避免文件类型和大小限制、网络问题等常见错误。优化大文件上传性能，考虑分片上传和优化网络传输。
UniApp文件上传：那些你可能不知道的坑
很多同学问我UniApp怎么上传文件，感觉很简单，不就是uni.uploadFile嘛？ 事实是，这玩意儿比你想象的要复杂得多，尤其是当你遇到各种奇葩的网络环境、服务器配置和文件类型时。 这篇文章，我不会给你那种教科书式的步骤，我会把我这些年踩过的坑，以及一些你可能没注意到的细节都抖搂出来。 读完这篇文章，你不仅能学会怎么上传文件，更能理解背后的一些原理，避免掉进那些令人抓狂的bug里。
先说结论，uni.uploadFile本身很简单，但要把它用好，需要你对HTTP协议、服务器端编程，甚至一些网络基础知识都有所了解。 别觉得夸张，你真以为随便写几行代码，就能搞定各种复杂的上传场景吗？
基础回顾：别忘了HTTP
UniApp用的是uni.uploadFile，底层是基于原生的XMLHttpRequest实现的。 这意味着，你得了解HTTP协议里关于文件上传的那些事，例如multipart/form-data。 这可不是什么高深莫测的东西，但你得知道它是怎么工作的，才能在遇到问题时快速定位。 简单来说，文件上传不是简单地把文件内容塞到请求体里，它需要一些额外的元数据，比如文件名、文件类型等等，这些元数据都包含在multipart/form-data中。
核心：uni.uploadFile的细节
uni.uploadFile的API文档你肯定看过，但你真的理解每个参数的含义吗？ url，filePath，name，formData…… 这些参数看似简单，但稍有不慎就会出错。 比如formData，你以为随便塞点东西进去就完事了？ 实际开发中，你可能需要处理一些特殊字符，或者处理服务器端对请求体大小的限制。
让我们来看一个例子，一个相对完善的UniApp文件上传代码：
部分功能简介：商品收藏夹功能热门商品最新商品分级价格功能自选风格打印结算页面内部短信箱商品评论增加上一商品，下一商品功能增强商家提示功能友情链接用户在线统计用户来访统计用户来访信息用户积分功能广告设置用户组分类邮件系统后台实现更新用户数据系统图片设置模板管理CSS风格管理申诉内容过滤功能用户注册过滤特征字符IP库管理及来访限制及管理压缩，恢复，备份数据库功能上传文件管理商品类别管理商品添加/修改/
uni.chooseFile({
count: 1,
type: 'image', //或者其他类型
success: (res) => {
let filePath = res.tempFiles[0].path;
let fileName = res.tempFiles[0].name;
uni.uploadFile({
url: '你的服务器地址',
filePath: filePath,
name: 'file', // 服务器端接收文件的字段名，注意这个！
formData: {
'userId': '123', // 额外参数，根据你的服务器需求添加
'fileType': res.tempFiles[0].type //文件类型，最好加上
},
header: {
'Content-Type': 'multipart/form-data' //这个很重要，虽然默认是这个，但最好显式声明
},
success: (res) => {
console.log('上传成功', JSON.parse(res.data)); //服务器返回的数据，记得解析！
},
fail: (err) => {
console.error('上传失败', err);
uni.showToast({title: '上传失败，请检查网络', icon: 'error'});
}
});
}
});高级用法：处理大文件和进度
上面的代码只是最基本的用法。 如果要上传大文件，你必须考虑进度显示和断点续传。 uni.uploadFile本身提供了onProgressUpdate回调函数，可以实时获取上传进度。 但断点续传需要你自行实现，这通常涉及到服务器端的配合。 别指望UniApp能自动帮你完成断点续传，这需要更复杂的逻辑和算法。
踩坑指南：那些让你抓狂的bug
-
服务器端配置： 服务器端必须正确配置才能处理
multipart/form-data类型的请求。 不同的服务器端语言和框架，配置方法也不一样。 别以为你客户端代码没问题，服务器端就一定没问题。 - 文件类型限制： 服务器端通常会对上传文件的类型进行限制，比如只允许上传图片或文档。 如果文件类型不符合要求，上传就会失败。
- 文件大小限制： 服务器端和客户端都可能对上传文件的大小有限制。 超过限制，上传也会失败。
- 网络问题： 网络不稳定是上传失败的常见原因。 你需要处理网络错误，并提供友好的用户体验。
性能优化：并非一蹴而就
对于大文件上传，优化性能至关重要。 你可以考虑使用分片上传，或者采用更优化的网络传输协议。 但这需要更深入的学习和实践。
总而言之，UniApp文件上传看似简单，实则暗藏玄机。 希望这篇文章能帮助你更好地理解和掌握UniApp文件上传，避免掉进那些令人头疼的坑里。 记住，实践出真知，多动手写代码，多调试，才能真正成为高手。
