当前位置：首页 > news >正文

Multer视频处理终极指南：上传后自动转码为多种分辨率的完整实现

news 2026/5/29 5:02:39

Multer视频处理终极指南：上传后自动转码为多种分辨率的完整实现

【免费下载链接】multerNode.js middleware for handling `multipart/form-data`.项目地址: https://gitcode.com/gh_mirrors/mu/multer

Multer是Node.js生态系统中处理multipart/form-data的终极解决方案，专为文件上传而设计。作为Express.js中间件，它能够高效处理表单数据中的文件上传需求，特别适合视频处理场景。本文将为您展示如何利用Multer实现视频上传后的自动转码功能，创建支持多种分辨率的完整视频处理系统。😊

为什么选择Multer进行视频处理？

Multer的核心优势在于其简单易用的API和强大的可扩展性。通过storage/disk.js和storage/memory.js两个内置存储引擎，您可以灵活选择文件存储方式。对于视频处理这种需要大文件存储的场景，磁盘存储引擎无疑是更好的选择。

Multer视频处理流程图：从上传到转码的完整流程

快速开始：安装与基本配置

首先，通过npm安装Multer：

npm install multer

基本配置非常简单，您可以在index.js中看到Multer的核心实现。创建一个简单的视频上传中间件：

const multer = require('multer') const upload = multer({ dest: 'uploads/videos/', limits: { fileSize: 500 * 1024 * 1024 } // 500MB限制 })

自定义存储引擎：为视频转码做准备

Multer的真正强大之处在于其可扩展的存储引擎架构。参考StorageEngine.md文档，我们可以创建专门用于视频处理的存储引擎：

const multer = require('multer') const { exec } = require('child_process') const path = require('path') const videoStorage = multer.diskStorage({ destination: function (req, file, cb) { cb(null, 'uploads/raw/') }, filename: function (req, file, cb) { const uniqueName = Date.now() + '-' + Math.round(Math.random() * 1E9) cb(null, uniqueName + path.extname(file.originalname)) } }) const upload = multer({ storage: videoStorage, fileFilter: function (req, file, cb) { // 只接受视频文件 if (file.mimetype.startsWith('video/')) { cb(null, true) } else { cb(new Error('只支持视频文件'), false) } } })

实现自动转码功能

上传完成后，我们可以添加转码逻辑来生成多种分辨率的视频版本：

const fs = require('fs') const ffmpeg = require('fluent-ffmpeg') app.post('/upload-video', upload.single('video'), async (req, res) => { try { const videoPath = req.file.path const resolutions = [ { name: '1080p', width: 1920, height: 1080 }, { name: '720p', width: 1280, height: 720 }, { name: '480p', width: 854, height: 480 }, { name: '360p', width: 640, height: 360 } ] // 为每个分辨率创建转码任务 const transcodePromises = resolutions.map(res => { return new Promise((resolve, reject) => { const outputPath = `uploads/transcoded/${req.file.filename}_${res.name}.mp4` ffmpeg(videoPath) .size(`${res.width}x${res.height}`) .output(outputPath) .on('end', () => { console.log(`${res.name}转码完成`) resolve({ resolution: res.name, path: outputPath }) }) .on('error', reject) .run() }) }) const results = await Promise.all(transcodePromises) res.json({ success: true, original: req.file, transcoded: results }) } catch (error) { res.status(500).json({ error: error.message }) } })

高级功能：文件过滤与错误处理

Multer提供了强大的文件过滤功能，这在lib/multer-error.js中有详细实现。我们可以利用这个功能来确保只处理特定类型的视频文件：

const upload = multer({ storage: videoStorage, fileFilter: function (req, file, cb) { const allowedTypes = ['video/mp4', 'video/avi', 'video/mov', 'video/wmv'] const maxSize = 500 * 1024 * 1024 // 500MB if (!allowedTypes.includes(file.mimetype)) { return cb(new Error('不支持的文件类型'), false) } if (file.size > maxSize) { return cb(new Error('文件大小超过限制'), false) } cb(null, true) }, limits: { fileSize: 500 * 1024 * 1024 } })