手動拼裝 multipart 體極易出錯(邊界、換行、編碼),生產環境**請直接使用成熟庫**。
const FormData = require("form-data");
const fs = require("fs");
const axios = require("axios");
async function uploadFile(filePath, fields = {}) {
const form = new FormData();
form.append("file", fs.createReadStream(filePath), {filename: "upload.jpg", contentType: "image/jpeg"});
Object.entries(fields).forEach(([k, v]) => form.append(k, v));
try {
const res = await axios.post("https://api.example.com/upload", form, {
headers: form.getHeaders(), // 關鍵:自動帶入 boundary
maxContentLength: Infinity,
maxBodyLength: Infinity
});
console.log("上傳成功:", res.data);
} catch (err) {
console.error("上傳失敗:", err.response?.data || err.message);
}
}
uploadFile("./00.jpg", {client: "1", title: "ok"});
async function uploadNative(filePath, fields = {}) {
const form = new FormData();
form.append("file", fs.createReadStream(filePath), "upload.jpg");
Object.entries(fields).forEach(([k, v]) => form.append(k, v));
const res = await fetch("https://api.example.com/upload", {
method: "POST",
body: form, // fetch 自動設置 Content-Type with boundary
// Node 18+ 不需手動設 headers,form 會自動注入 boundary
});
console.log(await res.json());
}
**僅供學習協議細節,生產勿用。**
const http = require("http");
const fs = require("fs");
const path = require("path");
function getMime(filename) {
const ext = path.extname(filename).toLowerCase();
const map = {".png":"image/png", ".jpg":"image/jpeg", ".jpeg":"image/jpeg", ".gif":"image/gif", ".pdf":"application/pdf"};
return map[ext] || "application/octet-stream";
}
function buildMultipart(fields, file) {
const boundary = "----NodeFormBoundary" + Math.random().toString(36).slice(2);
const CRLF = "\r\n";
const parts = [];
// 普通欄位
Object.entries(fields).forEach(([name, value]) => {
parts.push(
`--${boundary}`,
`Content-Disposition: form-data; name="${name}"`,
"",
String(value)
);
});
// 檔案欄位
const fileName = path.basename(file);
parts.push(
`--${boundary}`,
`Content-Disposition: form-data; name="file"; filename="${fileName}"`,
`Content-Type: ${getMime(fileName)}`,
"",
// 檔案內容稍後以 Buffer 形式拼接
"FILE_PLACEHOLDER"
);
parts.push(`--${boundary}--`, "");
const bodyHead = parts.join(CRLF).replace("FILE_PLACEHOLDER", ""); // 先不含檔案內容
const fileBuffer = fs.readFileSync(file);
const bodyTail = Buffer.from(CRLF + `--${boundary}--` + CRLF);
// 組合:head + file + tail
const headBuffer = Buffer.from(bodyHead);
return Buffer.concat([headBuffer, fileBuffer, bodyTail]), boundary;
}
async function postMultipart(url, fields, file) {
const parsed = new URL(url);
const [body, boundary] = buildMultipart(fields, file);
return new Promise((resolve, reject) => {
const req = http.request({
hostname: parsed.hostname,
port: parsed.port || 80,
path: parsed.pathname + parsed.search,
method: "POST",
headers: {
"Content-Type": `multipart/form-data; boundary=${boundary}`,
"Content-Length": body.length
}
}, res => {
let data = "";
res.on("data", chunk => data += chunk);
res.on("end", () => resolve({status: res.statusCode, body: data}));
});
req.on("error", reject);
req.write(body);
req.end();
});
}
// 使用
postMultipart("https://example.com/upload", {client:"1", title:"ok"}, "./00.jpg")
.then(console.log).catch(console.error);
------WebKitFormBoundaryABC123
Content-Disposition: form-data; name="file"; filename="00.jpg"
Content-Type: image/jpeg
------WebKitFormBoundaryABC123
Content-Disposition: form-data; name="client"
1
------WebKitFormBoundaryABC123
Content-Disposition: form-data; name="title"
ok
------WebKitFormBoundaryABC123--
--boundary 開頭,結尾 --boundary--。Content-Type。\r\n (CRLF),非 \n。