Skip to content

How to Fix Express.js Middleware Order Issues

DodaTech 2 min read

In this tutorial, you'll learn about How to Fix Express.js"Express" >}}.js Middleware Order Issues. We cover key concepts, practical examples, and best practices.

The Problem

Your Express.js routes return undefined for req.body, authentication middleware never runs, or static files return 404. Express executes middleware in the order it is registered, so middleware placed after routes is never called.

Quick Fix

Step 1: Move body-parser before routes

Without body-parser middleware registered first, req.body is undefined:

node -e "
const express = require('express');
const app = express();
app.get('/data', (req, res) => {
    res.json({ body: req.body });
});
app.use(express.json());
app.listen(3000);
"

Move app.use(<a href="/backend/nodejs/">express</a>.json()) before the route:

node -e "
const express = require('express');
const app = express();
app.use(express.json());
app.get('/data', (req, res) => {
    res.json({ body: req.body || 'no body' });
});
app.listen(3000);
"

Step 2: Place authentication middleware before protected routes

Register auth middleware before the routes it should protect:

const express = require('express');
const app = express();

const auth = (req, res, next) => {
    if (req.headers.authorization) return next();
    res.status(401).json({ error: 'Unauthorized' });
};

app.use(auth);
app.get('/secret', (req, res) => {
    res.json({ data: 'classified' });
});

Step 3: Serve static files before catch-all routes

Static file middleware must come before a wildcard route:

const express = require('express');
const app = express();

app.use(express.static('public'));
app.get('/*', (req, res) => {
    res.send('Catch-all route');
});

Step 4: Place error-handling middleware last

Error middleware must have four parameters and be registered after all routes:

app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).json({ error: 'Something broke' });
});

Alternative Solutions

Use a middleware stack visualization

Add logging throughout the middleware chain to trace execution order:

app.use((req, res, next) => {
    console.log(`${req.method} ${req.path} - ${new Date().toISOString()}`);
    next();
});

Chain middleware on specific routes

Apply middleware to individual routes instead of globally:

const requireAuth = (req, res, next) => {
    if (req.session?.userId) return next();
    res.redirect('/login');
};
app.get('/dashboard', requireAuth, (req, res) => {
    res.send('Dashboard');
});

Common Mistakes to Avoid

Registering routes before error-handling middleware. Error middleware with four parameters must be registered after all routes to catch errors.

Forgetting to call next() in middleware. If middleware does not call next(), the request hangs indefinitely. Always call next() or send a response.

Placing app.use(express.static()) after a catch-all route. Static file serving must come before any wildcard route that would intercept the requests.

Pro Tips

Use Morgan for request logging. Place morgan('combined') as the first middleware to log every request before any processing: app.use(morgan('combined')).

Use express.Router for modular middleware. Group related routes and middleware into router modules to keep your main app file clean.

Use helmet for security headers. Place helmet() before any routes to set security-related HTTP headers on every response.

Prevention

  • Register middleware in this order: parsing, logging, auth, static, routes, error handler.
  • Add console.log('middleware ran') inside middleware to verify execution order.
  • Use app.use() for global middleware and router.use() for route-specific middleware.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro