萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 模擬瀏覽器 multipart/form-data 檔案上傳完整實作

現代推薦:form-data + axios/fetch

手動拼裝 multipart 體極易出錯(邊界、換行、編碼),生產環境**請直接使用成熟庫**。

方案一:axios + form-data(最常用)

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"});

方案二:原生 fetch + FormData(Node 18+ 內建)

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());
}

教學用:手動構建 multipart 請求(理解原理)

**僅供學習協議細節,生產勿用。**


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);

標準 multipart 格式對照

------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--。
  • 標頭與體之間有**空行**(雙 CRLF)。
  • 檔案部分需 Content-Type。

常見坑點

  • 邊界字串不可出現在檔案內容中(隨機生成極長字串機率極低)。
  • 換行必須為 \r\n (CRLF),非 \n。
  • 大檔案必須用串流,不可一次性讀入記憶體。
copyright © 萬盛學電腦網 all rights reserved