done回调中直接赋值img.src常不显示，因后端返回的可能是相对路径或字段名错误，导致浏览器静默失败；必须确保返回可直接访问的完整URL，否则需手动拼接。
done 回调里直接赋值 img.src 为什么经常不显示？
因为 done 拿到的只是后端返回的数据，不是图片本身。如果后端返回的是相对路径（比如 /upload/abc.jpg），而前端直接塞进 img.src，浏览器会尝试从当前域名下加载该路径——但该文件可能还没写入磁盘、nginx 未配置静态路由、或跨域被拦截，最终静默失败，控制台只报 net::err_failed。
常见错误是没检查返回值结构，比如后端返回 {code:0, msg:"success", data:{url:"abc.jpg"}}，你却写成 res.data.url，实际应为 res.data.url 或 res.url，字段名不匹配就取不到地址。
- 必须确认后端返回的是**可直接访问的完整 URL**（含协议和域名），否则要手动拼接：
location.origin + res.data.url - 若后端只返回文件名或相对路径，需约定好静态资源访问前缀（如
https://cdn.example.com/），并在前端拼接 - 用
console.log(res)打印返回值，别凭印象写字段名
preview 回调和 done 的根本区别是什么？
preview 是 layui 2.8+ 新增的回调，只在用户选择文件时触发，且仅对 image/* 类型生效；它内部用 FileReader.readAsDataURL() 生成 base64，不是上传成功后的预览手段。
done 才是上传完成后的唯一可靠入口，但它不提供文件内容，只提供服务器响应。想“上传成功后插入预览图”，逻辑上只能靠后端返回一个可公开访问的地址，前端用这个地址创建 <img>。
-
preview不等于“上传后预览”，它是“选中后立即预览”，和上传动作无关 - 安卓 WebView、旧版 iOS Safari 对 base64 大图支持差，
preview在这些环境容易白屏或崩溃 - 如果你看到 demo 里
preview能预览，那是因为它发生在 choose 阶段，不是 done 阶段
如何安全插入预览图并避免 DOM 冲突？
直接 document.getElementById('preview').src = url 看似简单，但容易覆盖旧图、没容错、不支持多图。真实场景中，更推荐动态创建 <img> 并 append 到容器。
- 预览容器必须存在且 ID 正确，例如：
<div id="preview-container"></div> - 插入前清空旧内容：
document.getElementById('preview-container').innerHTML = '' - 创建新
img元素，设src后加个onerror回调，防止地址失效时页面空白：img.onerror = () => img.remove() - 给
img加 class 或 style 控制尺寸，避免拉伸变形，比如：img.style.maxWidth = '200px'
后端返回地址不可用时，前端能补救吗？
不能。上传成功 ≠ 图片可访问。后端返回地址前，必须确保：文件已落盘、Web 服务已映射该路径、HTTP 响应头允许跨域（如有）、CDN 已刷新（如使用）。
前端唯一能做的，是降级提示——比如 done 里发现 !res.data.url 或 fetch(url).catch(...) 失败，就显示“图片上传成功，但预览暂时不可用，请稍后刷新页面查看”。
别试图在前端重新读取文件再生成 base64 补救：此时 obj.files 已为空（layui 上传后自动清空），且用户已关闭文件选择框，无法再次获取原始 File 对象。
