解决 Express.js 中的 "Cannot GET /" 错误

该教程旨在帮助开发者理解和解决在使用 Node.js 和 Express.js 开发 Web 应用时遇到的 "Cannot GET /" 错误。文章将深入分析错误原因，提供代码示例，并介绍如何正确配置路由，确保服务器能够正确响应客户端请求。同时，也会涉及数据传递和请求处理等相关知识，帮助开发者构建更健壮的 Web 应用。

理解 "Cannot GET /" 错误

"Cannot GET /" 错误表明你的 Express.js 服务器收到了一个针对根路径 / 的 GET 请求，但是你的应用没有为该路径定义任何处理程序。这意味着服务器不知道如何处理这个请求，因此返回 404 (Not Found) 错误。

常见原因和解决方法

1. 缺少根路由定义:

   最常见的原因是没有定义处理根路径 / 的路由。你需要显式地告诉 Express.js 如何处理对根路径的 GET 请求。

   const express = require('express');
   const app = express();
   const port = 3000;
   
   app.get('/', (req, res) => {
     res.send('Hello World!');
   });
   
   app.listen(port, () => {
     console.log(`Server listening at http://localhost:${port}`);
   });

   登录后复制

   这段代码定义了一个处理根路径 / 的 GET 请求的路由。当用户在浏览器中访问 http://localhost:3000/ 时，服务器将返回 "Hello World!"。

2. 静态文件服务配置错误:

   如果你的应用依赖于静态文件（如 HTML、CSS、JavaScript 文件），你需要使用 express.static 中间件来提供这些文件。如果配置不正确，浏览器可能无法找到 index.html 文件，从而导致 "Cannot GET /" 错误。

   const express = require('express');
   const app = express();
   const port = 3000;
   
   // Serve static files from the 'public' directory
   app.use(express.static('public'));
   
   app.listen(port, () => {
     console.log(`Server listening at http://localhost:${port}`);
   });

   登录后复制

   在这个例子中，express.static('public') 指示 Express.js 从 public 目录提供静态文件。确保你的 index.html 文件位于 public 目录中。

3. 客户端请求路径错误:

   检查你的客户端代码（例如 JavaScript）中发送的请求路径是否正确。确保路径与服务器端定义的路由匹配。例如，如果你想访问 /all 路由，请确保你的客户端代码发送的是 /all 请求，而不是其他路径。

4. 中间件顺序问题:

   Express.js 中间件的顺序很重要。确保 express.static 中间件在其他路由定义之前配置。否则，Express.js 可能会尝试将请求路由到其他处理程序，而不是提供静态文件。

   const express = require('express');
   const app = express();
   const port = 3000;
   
   // Serve static files first
   app.use(express.static('public'));
   
   // Then define other routes
   app.get('/api/data', (req, res) => {
     res.json({ message: 'Data from the API' });
   });
   
   app.listen(port, () => {
     console.log(`Server listening at http://localhost:${port}`);
   });

   登录后复制

代码示例：使用 Express Router 组织路由

为了更好地组织你的路由，可以使用 express.Router()。这可以使你的代码更模块化和易于维护。

Get笔记

Get笔记，一款AI驱动的知识管理产品

125

查看详情

const express = require('express');
const bodyParser = require('body-parser');
const cors = require('cors');

const app = express();
const port = 3000;

// Middleware
app.use(bodyParser.urlencoded({ extended: false }));
app.use(bodyParser.json());
app.use(cors());
app.use(express.static('website'));

// Routes
const router = express.Router();

// In-memory data storage (for demonstration purposes)
const data = [];

// GET route
router.get('/all', (req, res) => {
  res.send(data); // Send the data array
});

// POST route
router.post('/add', (req, res) => {
  res.send('POST received');
});

// POST an animal
router.post('/animal', (req, res) => {
  data.push(req.body);
  const animal = req.body; // Get the animal data from the request body
  res.send(animal); // Send the received animal data back as the response
});

// Mount the router
app.use('/', router); // Mount the router at the root path

// Start the server
app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

在这个例子中，所有路由都定义在 router 对象上，然后通过 app.use('/', router) 将其挂载到根路径 / 上。 注意，挂载点会影响你的请求路径，例如，挂载在 /api 路径下，那么/all请求路径就变成了/api/all。

数据传递和请求处理

1. GET 请求:

   GET 请求通常用于从服务器获取数据。你可以使用 req.query 来访问 GET 请求中的查询参数。

   router.get('/search', (req, res) => {
     const searchTerm = req.query.q; // Access the 'q' query parameter
     // Perform a search based on the searchTerm
     res.send(`Searching for: ${searchTerm}`);
   });

   登录后复制

2. POST 请求:

   POST 请求通常用于向服务器发送数据。你需要使用 body-parser 中间件来解析 POST 请求的请求体。

   router.post('/submit', (req, res) => {
     const formData = req.body; // Access the form data
     // Process the form data
     res.json({ message: 'Form submitted successfully', data: formData });
   });

   登录后复制

3. 发送 JSON 响应:

   使用 res.json() 方法发送 JSON 响应。

   router.get('/data', (req, res) => {
     const data = { name: 'John Doe', age: 30 };
     res.json(data);
   });

   登录后复制

客户端代码示例

以下是一些客户端代码示例，展示如何使用 fetch API 发送 GET 和 POST 请求。

1. GET 请求:

   fetch('/all')
     .then(response => response.json())
     .then(data => {
       // Handle the received data
       console.log(data);
     })
     .catch(error => {
       // Handle any errors
       console.error('Error:', error);
     });

   登录后复制

2. POST 请求:

   const postData = async (url = "", data = {}) => {
     const response = await fetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
       },
       body: JSON.stringify(data),
     });
   
     try {
       const responseData = await response.json(); // Parse the response data as JSON
       console.log(responseData); // Display the received data
       return responseData;
     } catch (error) {
       console.error("Error:", error);
     }
   };
   
   const animalData = { animal: 'lion' };
   postData("/animal", animalData);

   登录后复制

注意事项

• 确保你的服务器正在运行，并且监听正确的端口。
• 检查你的防火墙设置，确保端口没有被阻止。
• 使用浏览器的开发者工具来调试网络请求和响应。
• 仔细检查你的代码，确保没有拼写错误或其他语法错误。

总结

"Cannot GET /" 错误通常是由于缺少根路由定义或静态文件服务配置错误引起的。通过理解错误原因，正确配置路由，并使用 express.static 中间件，你可以轻松解决这个问题。此外，使用 express.Router() 可以更好地组织你的路由，使你的代码更模块化和易于维护。 掌握数据传递和请求处理的技巧，可以帮助你构建更健壮的 Web 应用。

以上就是解决 Express.js 中的 "Cannot GET /" 错误的详细内容，更多请关注php中文网其它相关文章！