本文详解 express 中 post 路由与 url 参数的常见误用问题，指出 `post` 表单提交无法通过路径参数（`:target`）传递字段值，必须改用 `req.body` 解析，并强调路由路径需以 `/` 开头、响应必须显式结束等关键实践。
在 Express 应用中，一个高频错误是混淆 GET 与 POST 的数据传递机制：路径参数（如 :target）仅适用于 GET、PUT、DELETE 等可通过 URL 显式携带参数的请求方法；而标准 HTML 表单 。
你原始代码中的问题正是源于此：
// ❌ 错误：POST 表单不会向 '/articles/some_title' 发送请求，
// 且即使 URL 包含 :target，浏览器也不会自动将其填入 req.body
articlesRouter.post('articles/:target', /* ... */)同时，该路由定义缺少前导 /，导致 Express 将其解析为相对路径匹配（即仅匹配挂载点后的子路径），极易引发路由未命中——例如若 articlesRouter 挂载在 /api 下，则 'articles/:target' 实际匹配的是 /api/articles/:target，而非预期的 /articles/:target。
✅ 正确做法分三步：
-
明确区分请求意图：
- 若需根据文章标题操作（如创建评论），应将标题作为表单字段（如 name="articleTitle"）提交，后端从 req.body.articleTitle 读取；
- 若需定位某篇文章页面（如查看详情），才使用 GET /articles/:target + 路径参数。
-
修正 POST 路由定义与表单 action：
- 路由路径必须以 / 开头（如 /articles），确保绝对匹配；
- 表单 action 属性需指向该完整路径，例如
务必发送响应终止请求：
Express 不会自动结束响应，遗漏 res.send()、res.json() 或 res.status(200).end() 将导致客户端长期等待（超时或报 Cannot POST / 错误）。
以下是可直接运行的修正示例：
前端表单（views/create-article.ejs 或 HTML 文件）：
<form method="post" action="/articles"> <input type="text" name="articleTitle" placeholder="Article title (e.g., my_first_post)" required /> <textarea name="articleBody" placeholder="Article content"></textarea> <button type="submit">Publish</button> </form>
后端路由（routes/articles.js）：
const express = require('express');
const router = express.Router();
const Article = require('../models/Article'); // 假设已定义模型
// ✅ 正确：POST 路由不依赖 :target，从 req.body 获取数据
router.post('/articles', async (req, res) => {
try {
const { articleTitle, articleBody } = req.body;
// 注意：replaceAll 是安全的，但需 Node.js ≥ 15；旧版本可用 replace(/_/g, ' ')
const title = articleTitle?.replaceAll('_', ' ') || '';
if (!title.trim()) {
return res.status(400).send('Title is required');
}
const article = await Article.create({ title, body: articleBody || '' });
console.log('New article created:', article.title);
res.status(201).json({ success: true, article });
} catch (err) {
console.error(err);
res.status(500).json({ error: 'Failed to create article' });
}
});
module.exports = router;主应用（app.js）中挂载：
const articlesRouter = require('./routes/articles');
app.use(express.urlencoded({ extended: true })); // ✅ 必须启用，解析表单数据
app.use('/articles', articlesRouter); // 挂载到 /articles 基路径? 关键注意事项：
- express.urlencoded({ extended: true }) 中间件不可或缺，否则 req.body 始终为空对象；
- 若使用 JSON 提交（如 fetch），需额外添加 express.json()；
- 路径参数 :target 仅适用于 GET /articles/:target 这类“资源定位”场景，不应强加于 POST 创建操作；
- 生产环境建议添加输入校验、CSRF 防护及错误日志，避免裸露数据库异常。
遵循以上规范，即可彻底解决 Cannot POST / 错误，构建清晰、健壮的 Express 表单处理流程。
