该教程旨在帮助开发者理解和解决在使用 Node.js 和 Express.js 开发 Web 应用时遇到的 "Cannot GET /" 错误。文章将深入分析错误原因，提供代码示例，并介绍如何正确配置路由，确保服务器能够正确响应客户端请求。同时，也会涉及数据传递和请求处理等相关知识，帮助开发者构建更健壮的 Web 应用。
理解 "Cannot GET /" 错误
"Cannot GET /" 错误表明你的 Express.js 服务器收到了一个针对根路径 / 的 GET 请求，但是你的应用没有为该路径定义任何处理程序。这意味着服务器不知道如何处理这个请求，因此返回 404 (Not Found) 错误。
常见原因和解决方法
-
缺少根路由定义:
最常见的原因是没有定义处理根路径 / 的路由。你需要显式地告诉 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!"。
-
静态文件服务配置错误:
如果你的应用依赖于静态文件（如 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 目录中。
-
客户端请求路径错误:
检查你的客户端代码（例如 JavaScript）中发送的请求路径是否正确。确保路径与服务器端定义的路由匹配。例如，如果你想访问 /all 路由，请确保你的客户端代码发送的是 /all 请求，而不是其他路径。
-
中间件顺序问题:
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()。这可以使你的代码更模块化和易于维护。
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。
数据传递和请求处理
-
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}`); }); -
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 }); }); -
发送 JSON 响应:
使用 res.json() 方法发送 JSON 响应。
router.get('/data', (req, res) => { const data = { name: 'John Doe', age: 30 }; res.json(data); });
客户端代码示例
以下是一些客户端代码示例，展示如何使用 fetch API 发送 GET 和 POST 请求。
-
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); }); -
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 应用。
