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 文件名的乱码问题。整个过程无需修改请求流程，也无需引入额外依赖，简洁高效，兼容性也十分可靠。