Fix SyntaxError: Unexpected token o in JSON at position 1 in Express

This error occurs when Express tries to parse a malformed JSON request body. The client is sending invalid JSON or the Content-Type header is incorrect. Fix it by adding proper error handling middleware for JSON parse failures and validating the Content-Type header before parsing.

Reading the Stack Trace

Here's what each line means:

• at JSON.parse (<anonymous>): The native JSON.parse function encountered invalid JSON input and threw a SyntaxError.
• at parse (/app/node_modules/body-parser/lib/types/json.js:89:19): The body-parser JSON middleware attempted to parse the raw request body and received the malformed string.
• at IncomingMessage.onEnd (/app/node_modules/raw-body/index.js:287:7): The raw-body module finished reading the full request stream before handing the buffer to the JSON parser.

Common Causes

// Client-side
const data = { name: 'Alice' };
fetch('/api/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(JSON.stringify(data))
});

// Client-side
fetch('/api/users', {
  method: 'POST',
  body: JSON.stringify({ name: 'Alice' })
  // Missing Content-Type header
});

const express = require('express');
const app = express();
app.use(express.json());

// No error-handling middleware registered
app.post('/api/users', (req, res) => {
  res.json({ user: req.body });
});

app.listen(3000);

The Fix

Add an error-handling middleware that checks for body-parser's 'entity.parse.failed' error type. This catches malformed JSON and returns a descriptive 400 response instead of crashing with a 500.

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/users', (req, res) => {
  res.json({ user: req.body });
});

app.listen(3000);

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/users', (req, res) => {
  res.json({ user: req.body });
});

// Error-handling middleware for JSON parse errors
app.use((err, req, res, next) => {
  if (err.type === 'entity.parse.failed') {
    return res.status(400).json({ error: 'Invalid JSON in request body' });
  }
  next(err);
});

app.listen(3000);

Testing the Fix

const request = require('supertest');
const express = require('express');

function createApp() {
  const app = express();
  app.use(express.json());
  app.post('/api/users', (req, res) => res.json({ user: req.body }));
  app.use((err, req, res, next) => {
    if (err.type === 'entity.parse.failed') {
      return res.status(400).json({ error: 'Invalid JSON in request body' });
    }
    next(err);
  });
  return app;
}

describe('POST /api/users', () => {
  it('returns 400 for malformed JSON', async () => {
    const res = await request(createApp())
      .post('/api/users')
      .set('Content-Type', 'application/json')
      .send('{invalid}');
    expect(res.status).toBe(400);
    expect(res.body.error).toBe('Invalid JSON in request body');
  });

  it('returns 200 for valid JSON', async () => {
    const res = await request(createApp())
      .post('/api/users')
      .send({ name: 'Alice' });
    expect(res.status).toBe(200);
    expect(res.body.user.name).toBe('Alice');
  });
});

Run your tests:

npx jest --testPathPattern=body-parser

Pushing Through CI/CD

git checkout -b fix/express-body-parser-error,git add src/middleware/errorHandler.js src/__tests__/bodyParser.test.js,git commit -m "fix: add error-handling middleware for malformed JSON body",git push origin fix/express-body-parser-error

Your CI config should look something like this:

name: CI
on:
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npx jest --coverage
      - run: npm run lint

The Full Manual Process: 18 Steps

Here's every step you just went through to fix this one bug:

1. Notice the error alert or see it in your monitoring tool
2. Open the error dashboard and read the stack trace
3. Identify the file and line number from the stack trace
4. Open your IDE and navigate to the file
5. Read the surrounding code to understand context
6. Reproduce the error locally
7. Identify the root cause
8. Write the fix
9. Run the test suite locally
10. Fix any failing tests
11. Write new tests covering the edge case
12. Run the full test suite again
13. Create a new git branch
14. Commit and push your changes
15. Open a pull request
16. Wait for code review
17. Merge and deploy to production
18. Monitor production to confirm the error is resolved

Total time: 30-60 minutes. For one bug.

npm install bugstack-sdk

const { initBugStack } = require('bugstack-sdk')

initBugStack({ apiKey: process.env.BUGSTACK_API_KEY })

Deploying the Fix (Manual Path)

1. Run the test suite locally to confirm JSON parse errors return 400.
2. Open a pull request with the error-handling middleware changes.
3. Wait for CI checks to pass on the PR.
4. Have a teammate review and approve the PR.
5. Merge to main and verify the fix in staging before promoting to production.

Frequently Asked Questions