Cannot GET /path の原因と解決策

概要

Cannot GET /pathは、Expressで指定されたパスに対応するルートハンドラが見つからない場合に発生する404エラーです。

エラーメッセージ

Cannot GET /api/users
Cannot GET /dashboard

原因

ルートが定義されていない: パスに対するハンドラがない
ルートの順序: より具体的なルートが後に定義されている
HTTPメソッドの不一致: GET要求にPOSTハンドラのみ
ミドルウェアの順序: ルーターが正しく登録されていない

解決策

1. ルートを正しく定義

1
2
3
4
5
6
7
const express = require('express');
const app = express();

// ルートを定義
app.get('/api/users', (req, res) => {
  res.json({ users: [] });
});

2. ルーターを正しく登録

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
// routes/users.js
const router = express.Router();

router.get('/', (req, res) => {
  res.json({ users: [] });
});

module.exports = router;

// app.js
const usersRouter = require('./routes/users');
app.use('/api/users', usersRouter);

3. 静的ファイルの設定

1
2
3
4
5
6
7
// 静的ファイルを配信
app.use(express.static('public'));

// SPAのフォールバック
app.get('*', (req, res) => {
  res.sendFile(path.join(__dirname, 'public', 'index.html'));
});

4. ルートの順序を確認

1
2
3
4
5
6
// 具体的なルートを先に
app.get('/api/users/:id', (req, res) => { /* ... */ });
app.get('/api/users', (req, res) => { /* ... */ });

// ワイルドカードは最後に
app.get('*', (req, res) => { /* ... */ });

5. 404ハンドラを追加

1
2
3
4
5
6
7
// 全てのルートの後に
app.use((req, res, next) => {
  res.status(404).json({
    error: 'Not Found',
    path: req.path
  });
});

6. デバッグでルートを確認

1
2
3
4
5
6
// 登録されているルートを表示
app._router.stack.forEach((middleware) => {
  if (middleware.route) {
    console.log(middleware.route.path);
  }
});

概要

エラーメッセージ

原因

解決策

1. ルートを正しく定義

2. ルーターを正しく登録

3. 静的ファイルの設定

4. ルートの順序を確認

5. 404ハンドラを追加

6. デバッグでルートを確認

Node.js の他のエラー