uni-app 提交带图片反馈表单须用 uni.uploadFile,禁用 uni.request 发 multipart;图片需先 uni.chooseImage 获取临时路径,再传 filePath;文本字段拼 query 字符串入 formData,name 须与后端文件字段名严格一致。

uni-app 里怎么提交带图片的反馈表单
直接用 uni.uploadFile,别碰 uni.request 发 multipart 数据——它不支持小程序端的文件流上传,真机上必失败。
常见错误是把图片 base64 字符串拼进 JSON 一起 POST,结果:iOS 真机崩溃、安卓上传超时、小程序审核被拒(违反文件上传规范)。
- 图片必须走
uni.chooseImage→ 拿到临时路径 → 传给uni.uploadFile的filePath - 文本字段(如标题、描述)不能放
data里传对象,得用字符串拼成 query,例如:title=xxx&content=yyy - 后端接口必须能接收
multipart/form-data,且文件字段名要和前端name参数一致(比如后端 expectingfeedback_image,前端就得写name: 'feedback_image')
uni.uploadFile 的 name 和 formData 容易写错的地方
name 不是变量名,是后端解析文件字段用的 key;formData 是普通表单字段,但只接受字符串值,传对象会静默忽略。
比如用户填了「问题描述」和「联系方式」,不能这样写:
formData: { desc: this.desc, contact: this.contact }
得手动拼:
formData: `desc=${encodeURIComponent(this.desc)}&contact=${encodeURIComponent(this.contact)}`
-
name值前后空格会导致后端收不到文件(尤其复制示例代码时容易多一个空格) -
formData中中文不encodeURIComponent,服务端收到乱码(Node.js 默认 utf8,但 PHP/Java 某些配置下会截断) - 多个图片要多次调用
uni.uploadFile,别试图一次传数组——API 不支持
App 端(iOS/Android)图片上传的兼容性坑
App 端 uni.chooseImage 返回的 tempFilePaths 在 iOS 上可能是 file:// 协议路径,而 uni.uploadFile 要求的是本地绝对路径或合法临时路径;Android 一般没问题,但 iOS 15+ 某些版本会返回沙盒外路径导致上传失败。
- 务必在调用
uni.uploadFile前用uni.getFileInfo校验路径是否可读(尤其 iOS) - 如果校验失败,换用
uni.downloadFile把图片先下载到本地缓存目录,再传新路径 - 不要依赖
tempFilePaths[0]—— 用户可能没选图,数组为空,不判空直接上传会报uploadFile:fail invalid file path
用户点击提交后,怎么避免重复提交和 UI 错乱
没加防抖或状态锁,用户手快点两下,同一张图发两次,后端收到重复工单,客服懵了。
- 提交前设
isUploading = true,按钮disabled,加载态显式给出 - 成功或失败后都重置
isUploading,别只在 success 里重置——失败了用户点不了第二次 - 上传中不要清空表单内容,否则用户网络失败重试时得重新输一遍文字(尤其长反馈)
- 上传成功后跳转前,用
uni.hideLoading()主动收掉 loading,不然某些 Android 机型会卡住
最麻烦的其实是图片压缩逻辑:用户手机拍的图动辄 3–5MB,不压直接传,3G 网络下大概率超时。uni-app 没内置压缩 API,得自己用 uni.canvasToTempFilePath 或引入轻量库,这个点容易被跳过,等上线后才发现大量上传失败。










