Nodejs实现文件上传的示例代码

发布时间 - 2026-01-11 03:25:21    点击率:

笔者用nodejs做项目时需要用到文件上传的功能,在网上搜索了很多教程,找到了一个express的中间件,用于处理 multipart/form-data 类型的表单数据,可以很方便的将表单中的文件数据保存到服务器。

介绍

简单的用法

定义存储器

Multer作为express的一个中间件,我们可以很方便的自定义上传的文件目录以及保存的文件名。先看一个最简单的用法, demo1地址 :

var express = require('express');
var multer = require('multer');
var app = express();

var upload = multer({
  storage: multer.diskStorage({
    destination: function (req, file, cb){
      cb(null, './uploads/');
    },
    filename: function (req, file, cb){
      //file.originalname上传文件的原始文件名
      var changedName = (new Date().getTime())+'-'+file.originalname;
      cb(null, changedName);
    }
  })
});

我们先创建了一个upload对象,这个对象中destination函数用来定义上传文件的存储的文件夹;filename函数用来修改上传文件存储到服务器的文件名称,这里我们我们加上一个时间戳简单区分一下。这两个函数都是通过回调函数来实现的。每次上传的时候这两个函数都会调用一次,如果是多个文件上传,那个这两个函数就调用多次,调用顺序是先调用destination,然后调用filename。

在两个函数中都会有一个 file 对象,表示当前上传的文件对象,有以下几个属性:

  • fieldname:上传的字段名
  • originalname:上传的文件名
  • encoding:文件的编码类型
  • mimetype:文件的MIME类型

定义路由回调

//单个文件上传
app.post('/upload/single',upload.single('singleFile'),(req,res)=>{
  console.log(req.file);
  res.json({
    code: '0000',
    type:'single',
    originalname: req.file.originalname
  })
});

//多个文件上传
app.post('/upload/multer',upload.array('multerFile'),(req,res)=>{
  console.log(req.files);
  let fileList = [];
  req.files.map((elem)=>{
    fileList.push({
      originalname: elem.originalname
    })
  });
  res.json({
    code: '0000',
    type:'multer',
    fileList:fileList
  });
});

在express中定义路由的回调函数时,把定义好了的upload对象作为中间件添加进去。如果是单个文件就用 single 方法,如果是多个文件就用 array 方法,这两个方法都需要传一个页面上定义好的字段名。

在路由的回调函数中,request对象已经有了file属性(单个文件上传)或files属性(多个文件上传),files属性是一个数组,数组的每一个对象都有以下属性:

  • fieldname:上传的字段名
  • originalname:上传的文件名
  • encoding:文件的编码类型
  • mimetype:文件的MIME类型
  • destination:存储的目录(和destination回调函数中的目录名一致)
  • filename:保存的文件名(和filename回调函数中的文件名一致)
  • path:保存的相对路径
  • size:文件的大小(单位:字节byte)

我们可以发现在路由的回调函数中的file对象比diskStorage中的file对象多了几个属性,这是因为在diskStorage中文件还没有保存,只能知道文件的大致属性;而路由的回调函数文件已经在服务器上保存好了,文件的保存路径以及文件的大小都是已知的。

过滤文件上传

在文件上传时,有时候会上传一些我们不需要的文件类型,我们需要把一些不需要的文件给过滤掉。demo2地址 。

文件类型过滤

var upload = multer({
  //...其他代码
  fileFilter: function(req, file, cb){
    if(file.mimetype == 'image/png'){
      cb(null, true)
    } else {
      cb(null, false)
    }
  }
});

在定义存储器的时候,新增一个fileFilter函数,用来过滤掉我们不需要的文件,在回调函数中我们传入true/false来代表是否要保存;如果传了false,那么destination函数和filename函数也不会调用了。

文件大小和数量过滤

var upload = multer({
  //...其他代码
  limits:{
    //限制文件大小10kb
    fileSize: 10*1000,
    //限制文件数量
    files: 5
  }
});

在定义存储器的时候,新增一个limits对象,用来控制上传的一些信息,它有以下一些属性:

  • fieldNameSize:field 名字最大长度,默认值:100 bytes
  • fieldSize:field 值的最大长度,默认值:1MB
  • fields:非文件 field 的最大数量
  • fileSize:在multipart表单中, 文件最大长度 (字节单位)
  • files:在multipart表单中, 文件最大数量
  • parts:在multipart表单中, part传输的最大数量(fields + files)

在这边我们把fileSize的值设置得小一点,设为10kb方便测试看效果,但是如果这个时候会发现有报错。因为上传的文件大小很容易就会超过10KB,导致有报错出现,我们就需要在路由回调里对错误的情况进行捕获。

//单个文件上传
let singleUpload = upload.single('singleFile');
app.post('/upload/single',(req,res)=>{
  singleUpload(req,res,(err)=>{
    if(!!err){
      console.log(err.message)
      res.json({
        code: '2000',
        type:'single',
        originalname: '',
        msg: err.message
      })
      return;
    }
    if(!!req.file){
      res.json({
        code: '0000',
        type:'single',
        originalname: req.file.originalname,
        msg: ''
      })
    } else {
      res.json({
        code: '1000',
        type:'single',
        originalname: '',
        msg: ''
      })
    }
  });
});

//多个文件上传
let multerUpload = upload.array('multerFile');
app.post('/upload/multer', (req,res)=>{
  multerUpload(req,res,(err)=>{
    if(!!err){
      res.json({
        code: '2000',
        type:'multer',
        fileList:[],
        msg: err.message
      });
    }
    let fileList = [];
    req.files.map((elem)=>{
      fileList.push({
        originalname: elem.originalname
      })
    });
    res.json({
      code: '0000',
      type:'multer',
      fileList:fileList,
      msg:''
    });
  });
});

所有的demo代码都在这个 仓库里

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# Nodejs文件上传  # Node  # 实现文件上传  # node+multer实现图片上传的示例代码  # Nodejs进阶:基于express+multer的文件上传实例  # 使用express+multer实现node中的图片上传功能  # node + multer 实现文件上传过程  # 回调  # 文件上传  # 上传  # 多个  # 表单  # 这两个  # 不需要  # 都是  # 几个  # 好了  # 上传文件  # 我们可以  # 字段名  # 就用  # 报错  # 很方便  # 默认值  # 是一个  # 过滤掉  # 就会 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 消息称 OpenAI 正研发的神秘硬件设备或为智能笔,富士康代工  小米17系列还有一款新机?主打6.9英寸大直屏和旗舰级影像  如何基于PHP生成高效IDC网络公司建站源码?  详解MySQL数据库的安装与密码配置  家族网站制作贴纸教程视频,用豆子做粘帖画怎么制作?  laravel怎么通过契约(Contracts)编程_laravel契约(Contracts)编程方法  java ZXing生成二维码及条码实例分享  千库网官网入口推荐 千库网设计创意平台入口  高端建站三要素:定制模板、企业官网与响应式设计优化  用yum安装MySQLdb模块的步骤方法  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  昵图网官网入口 昵图网素材平台官方入口  Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧  香港服务器建站指南:外贸独立站搭建与跨境电商配置流程  美食网站链接制作教程视频,哪个教做美食的网站比较专业点?  西安专业网站制作公司有哪些,陕西省建行官方网站?  深圳网站制作培训,深圳哪些招聘网站比较好?  标题:Vue + Vuex + JWT 身份认证的正确实践与常见误区解析  如何快速配置高效服务器建站软件?  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  如何用VPS主机快速搭建个人网站?  百度输入法ai面板怎么关 百度输入法ai面板隐藏技巧  phpredis提高消息队列的实时性方法(推荐)  Java类加载基本过程详细介绍  Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  Swift中switch语句区间和元组模式匹配  php嵌入式断网后怎么恢复_php检测网络重连并恢复硬件控制【操作】  如何在阿里云完成域名注册与建站?  ,网页ppt怎么弄成自己的ppt?  微信小程序 input输入框控件详解及实例(多种示例)  手机钓鱼网站怎么制作视频,怎样拦截钓鱼网站。怎么办?  Laravel如何实现模型的全局作用域?(Global Scope示例)  Laravel如何升级到最新版本?(升级指南和步骤)  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode(.NET组件介绍之四)  香港服务器网站生成指南:免费资源整合与高速稳定配置方案  Laravel如何使用Guzzle调用外部接口_Laravel发起HTTP请求与JSON数据解析【详解】  Android自定义控件实现温度旋转按钮效果  Laravel如何实现全文搜索功能?(Scout和Algolia示例)  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站?  微信小程序 HTTPS报错整理常见问题及解决方案  Laravel如何使用Service Provider注册服务_Laravel服务提供者配置与加载  高配服务器限时抢购:企业级配置与回收服务一站式优惠方案  韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  零服务器AI建站解决方案:快速部署与云端平台低成本实践  Android利用动画实现背景逐渐变暗  b2c电商网站制作流程,b2c水平综合的电商平台?  Laravel如何实现用户密码重置功能?(完整流程代码)  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】