How to Handle File Upload Using Multer in Node.js

To handle file uploads in Node.js, use the multer middleware which processes multipart/form-data. Set up multer with a storage destination and use it as middleware in your route to receive files from client requests.

Why This Happens

Developers often try to handle file uploads in Node.js without using middleware that can parse multipart/form-data. This causes the server to not receive the file data correctly, resulting in empty or undefined file objects.

javascript

import express from 'express';
const app = express();

app.post('/upload', (req, res) => {
  console.log(req.file); // undefined
  res.send('File upload failed');
});

app.listen(3000);

Output

undefined

The Fix

Install and import multer. Configure it with a storage location. Use multer as middleware in your route to handle file uploads properly. This middleware parses the incoming file data and attaches it to req.file or req.files.

javascript

import express from 'express';
import multer from 'multer';

const app = express();
const upload = multer({ dest: 'uploads/' });

app.post('/upload', upload.single('file'), (req, res) => {
  console.log(req.file); // file info object
  res.send('File uploaded successfully');
});

app.listen(3000);

Output

File uploaded successfully

Prevention

Always use multer or similar middleware to handle file uploads in Node.js. Validate file types and sizes to avoid security risks. Keep your upload folder organized and clean up unused files regularly. Use descriptive field names and consistent client-server agreements on form data.

Related Errors

Common related errors include "req.file is undefined" when middleware is missing or misconfigured, and "MulterError: Unexpected field" when the field name in the form does not match the one in upload.single(). Fix these by ensuring middleware is applied and field names match exactly.

Key Takeaways

Use multer middleware to parse multipart/form-data for file uploads in Node.js.

Configure multer with a storage destination and use upload.single('fieldname') in routes.

Always validate and sanitize uploaded files to maintain security.

Match the form field name with the multer middleware field name exactly.

Without multer or similar middleware, file uploads will not be processed correctly.