必须在choose回调中手动为每个file对象挂载MD5,因File原生无md5属性;before无files属性无法计算;需用SparkMD5分片读取并严格在最后一块调用spark.end(),再通过Object.defineProperty或包装对象挂载,确保后续回调稳定读取。

choose回调里必须手动挂载MD5到每个file对象
layui的upload组件本身不提供文件MD5字段,obj.files里的每个File实例原生就没有md5属性。你不能指望在before或done里直接读file.md5——它根本不存在,除非你亲手塞进去。
常见错误是以为obj.pushFile()返回的队列项已经含MD5,其实它只返回ID映射;或者误在before里访问obj.files,结果报Cannot read property 'files' of undefined。
- 唯一可靠时机是
choose回调中遍历obj.files,对每个file单独启动SparkMD5分片计算 - 计算完成(
spark.end())后,立刻执行file.md5 = md5或Object.defineProperty(file, 'md5', {value: md5, writable: false}) - 别用
obj.files[i].md5 = ...直接赋值——部分浏览器会拒绝修改File原型上的属性,稳妥做法是用Object.assign新建一个带md5字段的对象包装原file
为什么不能等到before再算MD5
before回调里obj确实有upload()和preview()方法,但它**没有files属性**,文档明确写“仅choose回调暴露原始文件列表”。此时你连文件大小都拿不到,更别说读二进制内容了。
试图在before里调new FileReader().readAsArrayBuffer(obj.files[0]),必然触发TypeError: Cannot read property 'files' of undefined。
-
choose:能拿到File对象 → 可slice()→ 可分片读取 → 可算MD5 -
before:只有上传控制权 → 无文件数据 → 无法生成哈希 -
done/error:请求已发出/结束 → 秒传逻辑早已失效
查看队列中MD5的两种实操方式
挂载完成后,你有两条路查MD5:一是调试时直接打印obj.files,二是把MD5存到上传队列ID映射表里供后续调用。
- 调试查看:
console.log(obj.files)—— 如果你用了Object.defineProperty(file, 'md5', {...}),Chrome开发者工具里能看到新增的md5字段;若用包装对象,则需展开__proto__或看自定义属性 - 生产环境取用:在
choose里维护一个全局Map,如window.uploadMd5Map = new Map(),key为obj.pushFile()返回的ID,value为对应MD5,后续在before里通过obj.config.id查Map即可 - 注意:不要在
done里尝试obj.files[0].md5——多文件场景下obj.files在done里已被清空,只剩当前上传的单个file参数
大文件分片计算MD5时最容易漏掉的关键点
用SparkMD5.ArrayBuffer分片读取时,spark.end()只能调一次,且必须在所有onload执行完毕后立即调用。漏掉或重复调用,会导致返回undefined或错误哈希值。
- 每次
fileReader.onload触发后,必须调spark.append(e.target.result),不能漏任何一块 -
end位置必须严格落在最后一块读完之后,用currentChunk === chunks判断,别用currentChunk >= chunks - 切片边界要防越界:
end = Math.min(start + chunkSize, file.size),否则file.slice()返回null,spark.append(null)会静默失败 - 别用
readAsText或readAsDataURL——大文件直接卡死,必须用readAsArrayBuffer
真正难的不是算MD5,而是确保每一块都追加到位、spark.end()只调一次、挂载后的MD5能在后续任意回调里稳定读取。这三个环节任一出错,队列里的MD5就变成不可见的幽灵。











