layui upload 不自动转 base64,需在 choose 回调中用 FileReader 读取 file 并调用 readAsDataURL() 获取含 MIME 头的完整 data URI 字符串发送至后端;accept: 'images' 仅校验类型,不改变传输格式。

layui upload 本身不自动转 base64,必须手动在 choose 回调里用 FileReader 处理,否则上传的仍是二进制文件流(MultipartFile),不是 base64 字符串。
为什么不能直接靠 accept: 'images' 得到 base64
accept: 'images' 只是前端校验文件类型,不影响数据格式;layui 默认上传行为仍走 multipart/form-data,后端收到的是原始二进制流。要发 base64,必须拦截选择动作,自己读取并编码。
常见错误现象:
– 后端接收到的参数是空字符串或乱码
– done 回调里 res 没有返回值,但控制台看到 result 确实是 base64(说明前端生成成功,但没发出去)
– 误以为 obj.preview() 的 result 就是已上传数据,其实它只用于预览
choose 回调里用 FileReader 读取并拼装 data URI
关键点:不能依赖 obj.preview() 的 result 直接发给后端——它只是 canvas 渲染用的临时 base64,且不包含 MIME 头;需重新读取 file 对象,确保格式完整。
- 先调用
obj.pushFile()获取选中的File实例 - 用
new FileReader()读取file,readAsDataURL()会自动加data:image/xxx;base64,前缀 - 在
onload里拿到完整 data URI 字符串,再通过$.post或fetch发送到后端 - 不要在
preview回调里发请求,避免重复触发
示例片段:
choose: function(obj) {
var files = obj.pushFile();
var file = files[Object.keys(files)[0]]; // 取第一个文件
if (!file) return;
var reader = new FileReader();
reader.readAsDataURL(file);
reader.onload = function() {
var base64Str = this.result; // 包含 data:image/jpeg;base64,...
// 发送到后端,例如:
$.post('/user/updatePhoto', { face: base64Str }, function(res) {
console.log('上传成功');
});
};
}
后端接收 base64 并保存时的典型坑
base64 字符串传到后端后,不能直接当文件存——得先剥离头、解码、写入磁盘或数据库。
- 务必校验前缀是否为
data:image/开头,防止 XSS 或非法输入 - 用
substring()截掉data:...;base64,部分,再用java.util.Base64.getDecoder().decode()解码(Java) - 注意
base64Str可能含换行或空格,trim()再处理 - 如果存数据库,字段类型建议
TEXT或MEDIUMTEXT;若存本地,注意文件扩展名要从 MIME 类型推断(如image/png→.png)
容易被忽略的一点:前端生成的 base64 是纯文本,但长度可能超 1MB(尤其未压缩的 PNG),后端默认 request body size 限制(如 Tomcat 的 maxHttpPostSize)可能拦掉大图,需显式调大。











