表单action和method必须严格匹配Node.js路由配置，且需配置express.urlencoded()解析表单数据；文件上传须用multipart/form-data及multer，避免req.body为空。
表单 action 和 method 必须匹配 Node.js 路由配置
浏览器提交表单时，只认 action 指定的 URL 和 method（如 POST），不会自动加 API 前缀或 Content-Type。如果你的 Node.js 后端用 Express 定义了 app.post('/api/login')，那前端 action 就得写成 /api/login，不能只写 /login 或漏掉 method="POST"。
常见错误现象：404 Not Found（路径不一致）、405 Method Not Allowed（method 写成 GET 但后端只监听 POST）。
-
action值必须是绝对路径（如/submit）或完整 URL（如http://localhost:3000/submit），相对路径容易因当前 URL 变化而失效 - 确保后端已正确注册对应路由，例如 Express 中：
app.post('/submit', handler) - 如果后端启用了 CORS（比如用
cors()中间件），且前端不在同源下，需确认允许的 origin 和 method 包含POST
Node.js 后端必须解析 application/x-www-form-urlencoded
HTML 表单默认以 application/x-www-form-urlencoded 格式提交数据，不是 JSON。如果后端没配好解析中间件，req.body 会是空对象 {}，哪怕请求确实发过去了。
Express 用户必须显式启用 urlencoded 解析：
立即学习“前端免费学习笔记（深入）”；
app.use(express.urlencoded({ extended: true }));
extended: true 支持嵌套对象（如 user[name]），false 只支持扁平键值对。不用 express.json() —— 它只处理 JSON 请求，对普通表单无效。
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 遗漏
express.urlencoded()是导致req.body为空的最常见原因 - 如果同时支持表单和 AJAX JSON 提交，两个中间件都要加：
express.urlencoded()+express.json() - 使用原生 Node.js（无 Express）时，需手动监听
data和end事件，再用querystring.parse()解析
避免在表单提交后页面跳转丢失响应结果
原生 HTML 表单提交会触发整页刷新，后端返回的 JSON 或状态码无法被 JS 拿到。想做“提交后显示成功提示”，不能靠 res.json() 直接返回给表单，得换方式。
两种实用路径：
- 后端返回 HTML 页面（如重定向到
/success或渲染带提示的模板），适合简单场景 - 改用
fetch或axios提交，阻止默认行为：event.preventDefault()，再手动处理响应。这时要记得设置Content-Type和后端解析逻辑一致
示例（前端 fetch）：
document.querySelector('form').addEventListener('submit', async (e) => {
e.preventDefault();
const formData = new FormData(e.target);
const res = await fetch('/submit', {
method: 'POST',
body: formData // 自动设为 multipart/form-data；若只传键值对，可用 Object.fromEntries(formData) + JSON.stringify()
});
console.log(await res.json());
});
文件上传需要 enctype="multipart/form-data" 和专用解析器
普通文本字段用 urlencoded 就够了，但只要表单里有 <input type="file">，就必须设 enctype="multipart/form-data"，否则文件根本不会发出去。
此时后端不能再用 express.urlencoded() —— 它不处理 multipart。必须换用专门的库，比如 multer：
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });
app.post('/upload', upload.single('avatar'), (req, res) => {
console.log(req.file); // 文件信息
console.log(req.body); // 其他字段（仍可访问）
});
-
multer的dest是临时存储路径，别漏写；生产环境建议配memoryStorage或云存储适配器 - 表单中
<input name="avatar">的name必须和upload.single('avatar')里的字符串一致 - 如果同时有文本字段和文件，
req.body依然可用，但需等multer解析完才填充（它是中间件）
req.body 就是空的，连 debug 都找不到源头。 
