Multer文件上传希腊字符文件名乱码解决

在处理 Multer 文件上传时，遇到希腊字母等非 ASCII 字符的文件名乱码问题十分常见——例如出现 `Î Ïξ Îαξ` 这类乱码。本文将深入剖析乱码产生的根本原因，并提供一套行之有效的解决方案，重点演示在 `filename` 函数中如何通过 Latin-1 到 UTF-8 编码转换来彻底修复文件名称乱码。

在 Node.js 的 Express 生态中，Multer 几乎是处理文件上传的标准工具。然而，许多开发者都曾踩过这个坑：用户上传一个包含希腊字母（比如 αβγ.mp3）、中文或俄文的文件，结果服务器上保存的文件名变成了 `ασκος.mp3`——这并非 Multer 自身的 Bug，而是 HTTP 协议历史上遗留的编码问题。简单来说，浏览器在发送文件名时，大多采用 Latin-1（ISO-8859-1）编码，而 Node.js 默认按 UTF-8 解析，字节对应不上，自然就产生了乱码。

关键修复点在于：必须在 `filename` 回调函数内部，对 `file.originalname` 进行显式的 Latin-1 到 UTF-8 转码。如果等到路由处理逻辑再去修改，文件名已经以错误名称写入磁盘，而且 `req.files` 对象可能已被冻结，无法再改变。

下面是修正后的完整 Multer 配置示例：

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

这里有几个需要特别注意的地方：

• 不要在 `req.files[0].originalname = ...` 里转码：此时文件已经写入磁盘，Multer 核心流程已结束，强行修改无效甚至可能抛出 TypeError；
• `Buffer.from(..., 'latin1')` 是必需步骤：不能直接对 `file.originalname` 调用 `toString('utf-8')`，因为字符串已经是错误解码后的 JS 字符串，必须先将它还原为原始字节；
• 上传表单必须设置 `enctype="multipart/form-data"`，前端不要做多余的 URL 编码；
• 如果需要兼容旧版 IE 等特殊场景，可以添加一个容错逻辑：

  filename: (req, file, callback) => {  try {    const utf8Filename = Buffer.from(file.originalname, 'latin1').toString('utf-8');    callback(null, utf8Filename);  } catch (e) {    // 若转码失败，回退到安全文件名（如时间戳+哈希）    const safeName = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}${path.extname(file.originalname)}`;    callback(null, safeName);  }}

这套方案已在 Express 4.x/5.x 搭配 Multer 1.4.x+ 的环境中稳定验证，能够彻底解决希腊语、阿拉伯语、中文等多语言文件名的乱码问题，无需修改客户端代码，也无需额外安装中间件，稳定可靠。