uni-app无法用uni.renamefile重命名上传图片，因该api在app端无效、小程序报错、h5不适用临时文件；正确做法是在uni.uploadfile前通过name参数（app/小程序）或formdata.append第三参数（h5）传递自定义文件名，由后端决定保存名。
uni-app 无法直接给上传的图片“自动重命名”——因为 uni.renameFile 在 App 端完全不生效，H5 和小程序端虽有 API 但不适用于上传流程中的临时文件；真正能落地的方案，是**在调用 uni.uploadFile 前，把文件名塞进 formData 或 name 字段里**，由后端决定保存为什么名字。前端所谓“重命名”，本质是控制上传时的文件标识，而非操作本地文件系统。
为什么不能用 uni.renameFile 处理上传前的图片？
常见误解是想先保存再重命名，但问题卡在三处：
-
uni.renameFile在 App（iOS/Android）端调用无反应、无报错、也不执行，官方文档未明确标注，但实测失效 - 微信小程序中
tempFilePaths指向的是只读临时路径，renameFile会报错errCode: -1, errMsg: "renameFile:fail invalid file path" - H5 端虽支持
renameFile，但tempFiles[0].file是File对象，不是文件系统路径，无法传给该 API
上传时怎么让后端收到你想要的文件名？
关键在于：别动文件本身，改传给后端的「逻辑文件名」。不同平台获取文件的方式不同，但最终都可通过 uni.uploadFile 的 name 或 formData 控制：
- App 和 微信小程序：用
filePath参数传路径，同时设name: "avatar.jpg"—— 后端接收到的 multipart 字段名是avatar.jpg，多数服务端框架（如 Express、Spring Boot）会默认用这个值作为原始文件名 - H5：必须用
formData手动构造，把File对象 append 进去，并指定第二参数为自定义名，例如formData.append("file", file, "idcard_front.png") - 注意：
name字段是上传字段名（如file），不是文件名；真正影响后端保存名的是formData.append的第三个参数（H5）或服务端对Content-Disposition的解析（App/小程序）
如何生成有意义的自定义名（非时间戳）？
不要依赖客户端时间戳拼接，容易冲突或暴露隐私。推荐组合业务上下文生成稳定标识：
- 用户 ID + 时间戳（精确到毫秒）+ 随机后缀：
u12345_1754416925123_x8k2.png - 业务类型 + 表单 ID + 序号：
contract_78901_01.jpg - 若需语义化，可从
e.tempFiles[0].name（H5）或文件路径截取原始名（App/小程序），再做清洗：originalName.replace(/[^a-z0-9.]/gi, "_").toLowerCase() - 避免空格、中文、特殊符号；iOS 对文件扩展名大小写敏感，统一转小写更稳妥
App 端真要改本地文件名？只能 copy + remove
极少数场景（如离线缓存需按业务规则组织目录结构），必须操作本地文件系统，那就绕不过 uni.copyFile + uni.removeFile：
- 目标路径
destPath必须是绝对路径，且父目录存在（可用uni.getFileSystemManager().mkdir提前建好） - Android 10+ 要求写入
uni.env.USER_DATA_PATH，iOS 推荐用plus.io.resolveLocalFileSystemURL("_www")获取 Documents 根路径 - 复制成功回调里再删原文件，顺序不可颠倒；失败时原文件仍在，需加兜底日志
- 这一步和上传无关，只是本地管理，上传仍要走上面的
uni.uploadFile流程
最易被忽略的一点：H5 和小程序/APP 的文件名控制机制完全不同，不能写一套逻辑通吃；name 字段在 App/小程序里影响不大，真正起作用的是 formData 的第三参数（H5）或后端对请求头的解析逻辑。发请求前，务必用抓包工具（如 Charles 或微信开发者工具 Network 面板）确认实际发出的 multipart 中 filename 值是否符合预期。
