文件上传回调需捕获响应、更新状态并反馈用户，Vue 3中应通过on-success或axios.then处理，确认后端响应结构，用赋值而非push更新ref数组，分层判断错误并emit事件通知父组件。
文件上传完成后的回调处理，核心在于捕获成功响应、更新状态、反馈用户，并确保数据可被后续逻辑使用。Vue 3 中通常通过 on-success 钩子（如 Element Plus 的 el-upload）或 axios 请求的 then 链来实现，关键不是“有没有回调”，而是“回调里做什么才可靠”。
明确回调触发时机与参数结构
不同上传方式返回的数据结构差异较大，需先确认后端响应格式：
- Element Plus
el-upload的on-success回调接收三个参数：(response, file, fileList)，其中response是后端返回的完整响应体（不是response.data），除非配置了response-type="json" - 若用
axios手动上传，回调在.then(res => {...})中，res.data即业务数据 - 务必打印
response或res查看真实结构，避免误读为response.data.data等嵌套层级
更新响应式数据要避免直接 push
Vue 3 响应式系统对数组的变异方法（如 .push()、.splice()）支持有限，尤其在深层嵌套或 ref 包裹时易丢失更新。推荐统一用赋值方式：
- ✅ 正确：
fileList.value = [...fileList.value, { id: response.id, name: file.name, url: response.url }] - ❌ 风险：
fileList.value.push(...)可能不触发视图更新，尤其当fileList是ref([])且未做 shallowRef 或 reactive 处理时 - 若需保留原始顺序或去重，可在赋值前过滤：
fileList.value = fileList.value.filter(f => f.uid !== file.uid).concat(newItem)
错误处理与用户反馈不能只靠 console
上传失败不等于网络错误——可能是后端校验不通过（如文件类型不符、重复上传）、权限不足或服务不可用。回调中需分层判断：
立即学习“前端免费学习笔记（深入）”；
- 检查
response.code === '200'或自定义成功字段（如response.success === true），而非仅依赖 HTTP 状态码 - 后端返回错误信息时（如
response.message），用ElMessage.error(response.message)显示，而非alert - 网络异常或超时需在
on-error钩子或catch中单独处理，并重置上传状态（如isUploading.value = false）
需要父组件感知结果？用 emits 传递而不是 this
当上传逻辑封装在子组件中，父组件需知道“是否上传成功、上传了哪些文件、是否要清空表单”时，不要依赖 this.$emit（Vue 2 写法）或尝试修改父组件 props，而应：
- 子组件声明
emits: ['upload-success', 'upload-error'] - 在
on-success中调用：emit('upload-success', { fileId: response.id, fileName: file.name }) - 父组件绑定：
@upload-success="handleUploadSuccess"，在handleUploadSuccess中执行下一步（如提交表单、刷新列表） - 这样既解耦又可控，避免子组件越权操作父组件数据
