Multer文件上传希腊字符编码乱码解决方案

Multer 默认对文件名的编码处理不兼容非 ASCII 字符（如希腊字母），导致上传后文件名显示为乱码（如 ...）；本文提供一种基于 Buffer 编码转换的可靠解决方案，并集成到 multer 的 filename 钩子中。

问题现象

在实际开发中，用 Multer 处理文件上传时，经常会碰到一个让人头疼的问题：当客户端提交的文件名包含非 ASCII 字符（比如希腊字母 Πργραμμα.mp3），上传后保存下来的文件名却变成了一堆乱码，例如 ` ±...`。这背后的原因，是 HTTP 请求头里没有显式声明 `filename*` 参数（RFC 5987 格式），而 Multer 默认把原始字节流按照 Latin-1 解码，导致希腊字符被错误地映射成其他符号。

解决方案

要解决这个问题，核心思路其实很简单：在 Multer 的 `filename` 回调中，主动把 `file.originalname` 从 Latin-1 字节序列重新解码为 UTF-8 字符串。具体做法是通过 `Buffer.from()` 构造原始字节，指定源编码为 `'latin1'`，再转成 `'utf-8'`。下面是一个完整的示例代码：

const storage = multer.diskStorage({  destination: (req, file, callback) => {    callback(null, './uploads');  },  filename: (req, file, callback) => {    // 关键修复：将 Latin-1 字节流正确转为 UTF-8 字符串    const utf8Filename = Buffer.from(file.originalname, 'latin1').toString('utf-8');    callback(null, utf8Filename);  }});const limits = {  files: 100,  fileSize: 50000000};const upload = multer({  storage: storage,  fileFilter: (req, file, callback) => {    const ext = path.extname(file.originalname).toLowerCase();    if (!['.mp3', '.wa v', '.m4a', '.flac', '.aac'].includes(ext)) {      return callback(new Error('Only audio files (.mp3, .wa v, .m4a, .flac, .aac) are allowed.'));    }    callback(null, true);  },  limits: limits}).any('file');

注意事项：

• 这个方案假设客户端实际以 Latin-1 兼容编码（如 ISO-8859-7 或 Windows-1253）发送文件名——这是当前主流浏览器（Chrome/Firefox）在未指定 `filename*` 时的常见行为；
• 不要试图在 `req.files[0].originalname` 上后期修改（比如在中间件中），因为 `originalname` 是只读属性，而且 Multer 已经完成文件写入；必须直接在 `filename` 回调中完成转换；
• 如果服务端同时接收多语言文件（如中文、日文），该方案同样适用，因为 Latin-1 能无损映射任意单字节编码的原始字节；
• 更健壮的做法是配合前端使用 `filename*`（例如 `Content-Disposition: form-data; name="file"; filename*=UTF-8''%CE%A0%CF%81%CF%8C%CE%B3%CF%81%CE%B1%CE%BC%CE%BC%CE%B1.mp3`），但需要确保表单提交方式支持（如 FormData + fetch），而传统
  可能受限。

总的来说，只需在 `diskStorage.filename` 中插入一行 Buffer 编码转换，就能彻底解决希腊字符等非 ASCII 文件名的乱码问题。整个过程不需要修改请求流程，也不用引入额外依赖，简洁、高效，兼容性也足够可靠。