要在 Node.js 中把檔案 POST 到別人的伺服器,除了用現成套件,也可以自己動手組 multipart/form-data。這麼做的好處是徹底理解協定的每一個位元組,也方便在沒有套件的環境中實作。
請求本文由「邊界(boundary)」分隔成多個部分,每個部分開頭是一段標頭,接著空行,再來才是內容:
------WebKitFormBoundaryuzKmkAovUuYsQ1Dt
Content-Disposition: form-data; name="file"; filename="00.jpg"
Content-Type: application/octet-stream
(此處是檔案的位元組內容)
------WebKitFormBoundaryuzKmkAovUuYsQ1Dt
Content-Disposition: form-data; name="fieldName"
(此處是一般欄位的值)
------WebKitFormBoundaryuzKmkAovUuYsQ1Dt--
注意每個換行都是 \r\n,最後一個邊界後面還要多兩個 -- 表示結束。這些細節錯一個位元組,伺服器就會解析失敗。
var path = require("path");
var fs = require("fs");
var http = require("http");
var https = require("https");
// 一般文字欄位
var getfield = function (field, value) {
return 'Content-Disposition: form-data; name="' + field + '"\r\n\r\n' + value + '\r\n';
};
// 檔案欄位的標頭
var getfieldHead = function (field, filename) {
return 'Content-Disposition: form-data; name="' + field + '"; filename="'
+ filename + '"\r\n'
+ 'Content-Type: ' + getMime(filename) + '\r\n\r\n';
};
// 依副檔名判斷 MIME
var getMime = function (filename) {
var mimes = {
'.png': 'image/png',
'.gif': 'image/gif',
'.jpg': 'image/jpeg',
'.jpeg': 'image/jpeg',
'.js': 'application/javascript',
'.json': 'application/json',
'.torrent': 'application/octet-stream'
};
var mime = mimes[path.extname(filename).toLowerCase()];
return mime || 'application/octet-stream';
};
// 產生隨機邊界字串
var getBoundary = function () {
return Math.random().toString(36).slice(2);
};
var getBoundaryBorder = function (boundary) {
return '--' + boundary + '\r\n';
};
// 把所有文字欄位組成一整段
function fieldPayload(opts) {
var payload = [];
for (var id in opts.field) {
payload.push(getfield(id, opts.field[id]));
}
payload.push("");
return payload.join(getBoundaryBorder(opts.boundary));
}
// 以串流方式讀檔,合併成 Buffer 後交給回呼
function filereadstream(opts, fn) {
var readstream = fs.createReadStream(opts.file, { flags: 'r', encoding: null });
var chunks = [];
var length = 0;
readstream.on('data', function (chunk) {
length += chunk.length;
chunks.push(chunk);
});
readstream.on('end', function () {
var buffer = Buffer.alloc(length); // 新版請用 Buffer.alloc
var pos = 0;
for (var i = 0; i < chunks.length; i++) {
chunks[i].copy(buffer, pos);
pos += chunks[i].length;
}
fn(buffer);
});
}
function postRequest(opts) {
filereadstream(opts, function (buffer) {
var options = require('url').parse(opts.url);
var h = getBoundaryBorder(opts.boundary); // 起始邊界
var e = fieldPayload(opts); // 文字欄位
var a = getfieldHead(opts.param, path.basename(opts.file)); // 檔案標頭
var d = "\r\n" + h.replace(/\r\n$/, '--\r\n'); // 結束邊界
var headers = {};
headers["Content-Length"] = Buffer.byteLength(h + e + a) + buffer.length + Buffer.byteLength(d);
headers["Content-Type"] = 'multipart/form-data; boundary=' + opts.boundary;
options.headers = headers;
options.method = 'POST';
var client = options.protocol === 'https:' ? https : http;
var req = client.request(options, function (res) {
var data = '';
res.on('data', function (chunk) { data += chunk; });
res.on('end', function () {
console.log(res.statusCode);
console.log(data);
});
});
req.on('error', function (err) { console.error(err); });
req.write(h + e + a);
req.write(buffer);
req.end(d);
});
}
// 使用方式
var opt = {
"url": "https://xxxx.xx", // 目標網址
"file": "00.jpg", // 檔案路徑
"param": "file", // 檔案欄位名稱
"field": { // 其餘要一起送出的欄位
"client": "1",
"title": "ok"
},
"boundary": "----WebKitFormBoundary" + getBoundary()
};
postRequest(opt);
Buffer.byteLength() 計算,不能用 str.length,否則長度不符會導致 hangs 或截斷。\n 大多數伺服器會直接拒絕。encoding 必須是 null,若指定 utf-8 會破壞圖片。new Buffer(length) 請改用 Buffer.alloc(length)。除非你就是想理解協定,正式專案建議直接用成熟套件,它會幫你處理邊界、串流與錯誤:
const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch'); // Node 18+ 可直接用全域 fetch
const form = new FormData();
form.append('client', '1');
form.append('title', 'ok');
form.append('file', fs.createReadStream('00.jpg'));
fetch('https://xxxx.xx', { method: 'POST', body: form })
.then(r => r.text())
.then(console.log);
Node 18 之後內建的 FormData 與 fetch 已能勝任,連額外套件都省了。