微信小程序里怎么把文件转成 Base64

调 wx.getFileSystemManager().readFile,传 encoding: "base64",回调里的 res.data 就是 Base64 字符串。单个文件上限 100M。

  • readFile 传 encoding: base64,不传拿到的是 ArrayBuffer
  • 单个文件上限 100M,超了报 1300202
  • chooseMessageFile 给的 tempFiles[0].path 就是本地路径
  • 分片用 position / length,切片长度取 3 的倍数
b64file — converter · local

粘贴即自动处理,不用点按钮(Ctrl+Enter 立刻转换 / Esc 清空)

粘贴、拖拽、Ctrl+V 截图都行

[01]

最短能跑的一段

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 是字符串,两个都打进日志,回头查的时候省事。

[02]

文件从哪来

从聊天记录里选文件用 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 一模一样,代码不用改。

[03]

大文件: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。多一道转换就多一份内存,还多一段可能出错的代码。

[04]

报错对照

错误码含义先查什么
1300002文件不存在临时路径是否已失效、拼路径时少没少斜杠
1300021路径是个目录filePath 传成了文件夹
1300202超过 100M 或存储不足文件大小、本地空间
1300203base64 编码失败参数是否合法
1300005读写异常文件是否被占用

1300002 出现最多,八成是临时路径已经失效,或者拼接时少了斜杠。先调 fs.access 确认文件在,再去读。

码值以 errCode 为准。同一件事的 errMsg 文字会随基础库版本微调,用文字做判断迟早踩坑。

本机想验证编出来的 Base64 对不对,贴进 Base64 转文件 还原一次最快;浏览器里的对照写法在 JavaScript 用法 那页。

常见问题

readFile 拿到的是字符串还是 ArrayBuffer?

看 encoding。传了 base64 就是字符串,不传就是 ArrayBuffer,两种都能用,看下游要什么。

Base64 能直接传给 wx.request 吗?

能,当成普通字符串放进 body。体积会涨三分之一,接口自己的长度限制该看还得看。

临时路径能当图片地址用吗?

能,image 组件的 src 直接填本地路径就显示。别拼成 http 请求发出去,那是本地文件。

开发者工具正常,真机报错?

先查两处:本地路径的协议在开发者工具和真机上不一样,别硬编码;文件可能已经被清理。用 access 先探一下存在性。

相关工具与指南