如何解决 Multer 文件上传时希腊字符编码乱码问题

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

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

在使用 Multer 处理文件上传时，若客户端以非 UTF-8 编码（常见为 ISO-8859-7 或 Windows-1253，但被 Node.js 误判为 Latin-1）提交含希腊字符的文件名，Multer 会将其原始字节流直接当作 Latin-1 解码，造成后续显示为乱码（例如 Πρόγραμμα.mp3 变成 Î Ïξ Îαξ...）。根本原因在于 HTTP 请求头未显式声明 Content-Disposition 中的 filename* 参数（RFC 5987 格式），而 Multer 无法自动识别原始编码。

正确解决方案是：在 filename 函数中主动将 file.originalname 从 Latin-1 字节序列重新解码为 UTF-8 字符串。 这需借助 Buffer 构造原始字节并指定源编码，再转为目标编码：

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', '.wav', '.m4a', '.flac', '.aac'].includes(ext)) {      return callback(new Error('Only audio files (.mp3, .wav, .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），而传统 <form> 可能受限。

综上，通过在 diskStorage.filename 中插入一行 Buffer 编码转换，即可彻底解决希腊字符等非 ASCII 文件名的乱码问题，无需修改请求流程或引入额外依赖，简洁、高效、兼容性强。