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

本文介绍在使用 Multer 处理文件上传时，因客户端与服务器编码不一致导致希腊字母等非 ASCII 字符文件名显示为乱码（如 Î Ïξ Îαξ）的根本原因及可靠解决方案，重点演示如何在 filename 函数中正确进行 Latin-1 到 UTF-8 的编码转换。

本文介绍在使用 multer 处理文件上传时，因客户端与服务器编码不一致导致希腊字母等非 ascii 字符文件名显示为乱码（如 `Î Ïξ Îαξ`）的根本原因及可靠解决方案，重点演示如何在 `filename` 函数中正确进行 latin-1 到 utf-8 的编码转换。

在基于 Express 的 Node.js 应用中，Multer 是最常用的文件上传中间件。但当用户上传包含希腊字符（如 αβγ.mp3）、中文、俄文等 Unicode 文件名时，常出现类似 ασκος.mp3 的乱码——这并非 Multer 本身的 Bug，而是 HTTP 协议对 Content-Disposition 中 filename 字段的编码限制所致：浏览器通常以 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', '.wav', '.m4a', '.flac', '.aac'];    if (!allowedTypes.includes(ext)) {      return callback(new Error('Only audio files (.mp3, .wav, .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+ 环境中稳定验证，可彻底解决希腊语、阿拉伯语、中文等多语言文件名乱码问题，无需修改客户端或依赖额外中间件。