微信小程序里怎么把文件转成 Base64
调 wx.getFileSystemManager().readFile,传 encoding: "base64",回调里的 res.data 就是 Base64 字符串。单个文件上限 100M。
- readFile 传 encoding: base64,不传拿到的是 ArrayBuffer
- 单个文件上限 100M,超了报 1300202
- chooseMessageFile 给的 tempFiles[0].path 就是本地路径
- 分片用 position / length,切片长度取 3 的倍数
粘贴即自动处理,不用点按钮(Ctrl+Enter 立刻转换 / Esc 清空)
拖文件进来,或 ——截图直接 Ctrl+V 也行
任意类型 · 100 MB 封顶
粘贴、拖拽、Ctrl+V 截图都行
最短能跑的一段
const fs = wx.getFileSystemManager();
fs.readFile({
filePath: tempFilePath, // 本地路径,不能是 http 地址
encoding: 'base64',
success(res) {
console.log(res.data); // Base64 字符串
},
fail(err) {
console.error(err.errCode, err.errMsg);
}
});encoding 的合法值里有 base64,也有 utf8、hex、binary 这些。这个参数不传,读出来是 ArrayBuffer,你自己再处理二进制。
小程序里没有 window.btoa,浏览器那套写法搬不过来。老接口 wx.arrayBufferToBase64 官方已经不推荐,新代码让 readFile 直接输出 base64 就行,少一步转换。
fail 回调里 errCode 是数字、errMsg 是字符串,两个都打进日志,回头查的时候省事。
文件从哪来
从聊天记录里选文件用 wx.chooseMessageFile,基础库 2.5.0 起支持。
wx.chooseMessageFile({
count: 1,
type: 'file',
success(res) {
const f = res.tempFiles[0]; // f.path / f.name / f.size / f.type
}
});每项带 path、name、size、type,那个 path 是本地临时文件路径,直接喂给 readFile。2.6.0 起还能用 extension 按后缀过滤,比如只收 ['pdf']。
另一条来路是 wx.downloadFile 的 tempFilePath,同样能读。临时文件只在当前生命周期内保证有效,重启之后不一定还在。要留着就 saveFile 或 copyFile 转成本地缓存文件、本地用户文件,这两类加起来最多 200MB。
想造个测试文件,往 wx.env.USER_DATA_PATH 写一个再读回来,链路跟真机一致,比在开发者工具里手动传文件稳。
type 传 image 或 video 时拿到的也是临时路径,读法跟 file 一模一样,代码不用改。
大文件:100M 上限和分片读
readFile 单个文件上限 100M,超了直接抛 1300202。这个数字一般不挡路,卡人的是内存:100M 的文件编成 Base64 就是 133M 个字符,一次性塞进运行时,中低端安卓机容易直接闪退。
分片读靠 position 和 length,单位都是字节,区间左闭右开,基础库 2.10.0 起支持。
fs.readFile({
filePath: tempFilePath,
encoding: 'base64',
position: offset, // 起始字节
length: 3 * 1024 * 1024, // 这一片读多少字节
success(res) { /* res.data 是这一片的 base64 */ }
});切片长度取 3 的倍数。Base64 每 3 个字节编成 4 个字符,长度不是 3 的倍数,每片末尾都会补 =,拼起来中间夹着填充符,整段解不回去。最后一片不受这条约束。
几 MB 以内的文件整读就够了,别为了分片把代码写复杂。分片适合边读边传、上传前要过一道处理这类场景。
分片读出来的每一段都能单独解,拼的是编码结果,别想着先拼二进制再整体转一次。
真要传大文件,更省事的路子是 wx.uploadFile 直接传文件,根本不用在客户端转 Base64。多一道转换就多一份内存,还多一段可能出错的代码。
报错对照
| 错误码 | 含义 | 先查什么 |
|---|---|---|
| 1300002 | 文件不存在 | 临时路径是否已失效、拼路径时少没少斜杠 |
| 1300021 | 路径是个目录 | filePath 传成了文件夹 |
| 1300202 | 超过 100M 或存储不足 | 文件大小、本地空间 |
| 1300203 | base64 编码失败 | 参数是否合法 |
| 1300005 | 读写异常 | 文件是否被占用 |
1300002 出现最多,八成是临时路径已经失效,或者拼接时少了斜杠。先调 fs.access 确认文件在,再去读。
码值以 errCode 为准。同一件事的 errMsg 文字会随基础库版本微调,用文字做判断迟早踩坑。
本机想验证编出来的 Base64 对不对,贴进 Base64 转文件 还原一次最快;浏览器里的对照写法在 JavaScript 用法 那页。
常见问题
readFile 拿到的是字符串还是 ArrayBuffer?
看 encoding。传了 base64 就是字符串,不传就是 ArrayBuffer,两种都能用,看下游要什么。
Base64 能直接传给 wx.request 吗?
能,当成普通字符串放进 body。体积会涨三分之一,接口自己的长度限制该看还得看。
临时路径能当图片地址用吗?
能,image 组件的 src 直接填本地路径就显示。别拼成 http 请求发出去,那是本地文件。
开发者工具正常,真机报错?
先查两处:本地路径的协议在开发者工具和真机上不一样,别硬编码;文件可能已经被清理。用 access 先探一下存在性。