前端通过input选择图片,使用FormData和fetch将文件发送至Node.js后端;后端利用Express和multer中间件接收并保存图片到uploads目录,返回路径供前端展示。

前端上传图片到后端,通常通过表单数据(FormData)将文件发送给Node.js服务器,后端使用中间件如 multer 处理上传。下面是一个完整的流程说明,涵盖前端HTML+JS实现、Node.js后端接收与保存图片的全过程。
前端:选择并上传图片
用户通过 input[type="file"] 选择图片,JavaScript 使用 FormData 和 fetch 将文件发送到后端。
示例代码:
async function uploadImage() {
const input = document.getElementById('imageInput');
const file = input.files[0];
if (!file) {
alert("请选择一张图片");
return;
}
const formData = new FormData();
formData.append('picture', file); // 'picture' 是后端字段名
try {
const response = await fetch('http://localhost:3000/upload', {
method: 'POST',
body: formData
});
const result = await response.json();
console.log('上传成功:', result);
} catch (error) {
console.error('上传失败:', error);
}
}关键点: 不需要手动设置 Content-Type,浏览器会自动为 FormData 设置 boundary;后端需匹配字段名(如 picture)。
立即学习“前端免费学习笔记(深入)”;
Node.js 后端:接收并保存图片
使用 Express 搭建服务,配合 multer 中间件处理 multipart/form-data 类型的请求。
安装依赖:
npm init -y npm install express multer
服务器代码(app.js):
const express = require('express');
const multer = require('multer');
const path = require('path');
const app = express();
// 配置 multer 存储
const storage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, 'uploads/'); // 图片保存路径
},
filename: (req, file, cb) => {
const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
cb(null, file.fieldname + '-' + uniqueSuffix + path.extname(file.originalname));
}
});
const upload = multer({ storage: storage });
// 处理上传请求
app.post('/upload', upload.single('picture'), (req, res) => {
if (!req.file) {
return res.status(400).json({ error: '没有文件上传' });
}
// 返回图片访问路径(相对或绝对)
res.json({
message: '上传成功',
filename: req.file.filename,
path: '/uploads/' + req.file.filename
});
});
// 提供静态资源访问
app.use('/uploads', express.static('uploads'));
// 启动服务
app.listen(3000, () => {
console.log('服务器运行在 http://localhost:3000');
});说明: multer 的 single('picture') 对应前端 append 的字段名;diskStorage 可自定义存储位置和文件名。
完整流程总结
- 用户在前端选择图片文件
- JavaScript 创建 FormData 并添加文件
- fetch 发送 POST 请求到 Node 服务器
- Express 使用 multer 解析 multipart 表单数据
- 图片保存到本地 uploads 目录
- 返回文件名或 URL 给前端用于展示
确保 uploads 文件夹存在,否则会报错。可进一步扩展功能:限制大小、验证类型、生成缩略图、上传至云存储等。
基本上就这些,不复杂但容易忽略细节,比如字段名一致性和静态资源托管。










