开发者笔记

Egg.js学习与实战系列 · 文件上传配置

字数：443 阅读时长：2分钟 阅读：85

在使用Egg.js搭建文件上传服务时，遇到了几个一般新手都会遇到的坑。
经查阅官方文档，Egg框架中默认使用egg-multipart插件进行文件上传，所以上传文件前需要做相关的配置。

EggJS

上传文件提示： filetype undefined （图片可以上传，不报错）

  • 原因：没有给egg指定上传文件的类型

解决方法： 在config中添加如下配置

1
2
3
4
// config/config.default.js
config.multipart = {
  mode: 'file',  // 对应文件类型 
}

上传 txt 文件提示：Invalid filename

  • 原因：egg-multipart有对上传文件的后缀名限制的白名单(whitelist)，.txt后缀没有在默认whitelist中，导致上传失败。

  • 默认白名单：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
const whitelist = [
  // images
  '.jpg', '.jpeg', // image/jpeg
  '.png', // image/png, image/x-png
  '.gif', // image/gif
  '.bmp', // image/bmp
  '.wbmp', // image/vnd.wap.wbmp
  '.webp',
  '.tif',
  '.psd',
  // text
  '.svg',
  '.js', '.jsx',
  '.json',
  '.css', '.less',
  '.html', '.htm',
  '.xml',
  // tar
  '.zip',
  '.gz', '.tgz', '.gzip',
  // video
  '.mp3',
  '.mp4',
  '.avi',
];

解决方法： 在config中添加如下配置

1
2
3
4
5
6
// config/config.default.js
config.multipart = {
  fileExtensions: [
    '.txt',
  ],
}

上传大文件提示：Reach fileSize limit

解决方法： 在config中添加如下配置

1
2
3
4
// config/config.default.js
config.multipart = {
  fileSize: '100mb',  // Max file size (in bytes), default is 10mb
}

参考文档：

《Egg.js学习与实战》系列

欢迎访问：个人博客地址

本文作者： Tiven
发布时间： 2021-09-18
最后更新： 2023-03-02
本文标题： Egg.js学习与实战系列 · 文件上传配置
本文链接： https://www.tiven.cn/p/a31793d2/
版权声明： 本作品采用 CC BY-NC-SA 4.0 许可协议进行许可。转载请注明出处！
欢迎留言，提问 ^_^