Postman上传文件时中文名称乱码怎么办_Postman文件名编码问题排查-java教程-PHP中文网

Postman 上传中文文件名乱码的根源在于服务端未按 RFC 6266 正确解析 Content-Disposition 中的 filename 字段，Postman 本身已合规生成 filename（ASCII）和 filename=utf-8''%E4%B8%AD%E6%96%87.jpg 格式。

postman上传文件时中文名称乱码怎么办_postman文件名编码问题排查

Postman 上传文件时中文名乱码，根本不是 Postman 的锅，而是服务端没按 RFC 6266 正确解析 Content-Disposition 中的 filename* 字段 —— 你得先确认后端是否真正支持 UTF-8 文件名解码。

为什么 Postman 上传的中文文件名在服务端变成问号或

Postman 本身对上传文件的中文名处理是合规的：它会把 multipart/form-data 请求中每个 part 的 Content-Disposition 头按 RFC 标准生成，包含 filename（ASCII fallback）和 filename*（UTF-8 编码值）。但很多后端框架（尤其是老版本 Spring Boot、Node.js multer、Java Servlet 容器）默认只读 filename 字段，且用平台默认编码（如 ISO-8859-1）解码，导致中文直接崩坏。

现象：服务端 file.getOriginalFilename() 返回 "???.jpg" 或 "%E4%B8%AD%E6%96%87.jpg" 未解码
关键点：filename* 的格式必须是 filename*=utf-8''%E4%B8%AD%E6%96%87.jpg（注意两个单引号），少一个引号或大小写错（如 UTF-8）都会被忽略
验证方式：在 Postman 的 Console 面板里点开请求 → Headers → 找到 Content-Disposition，确认是否存在 filename*= 字段且格式正确

Spring Boot + MultipartFile 中文文件名修复

Spring Boot 5.3+ 默认已支持 filename*，但低版本（如 2.7.x）需手动启用；即使新版，若用了 Nginx 或 Tomcat 前置代理，也可能被截断或转义。

检查 application.yml 是否禁用了标准解析：spring.servlet.multipart.resolve-lazily: false（应为 true 或删掉）
确保 Controller 方法参数明确使用 @RequestPart("file") MultipartFile file，而非 @RequestParam —— 后者不走 multipart 解析链
若仍失败，在 Controller 入口加临时调试：

String disposition = request.getHeader("Content-Disposition");
log.info("Raw Content-Disposition: {}", disposition); // 看是否含 filename*

终极兜底：手动从 header 提取 filename* 并用 URLDecoder.decode(..., "UTF-8") 解码，别依赖 file.getOriginalFilename()

Node.js（Express + Multer）中文文件名失效

Multer 默认不处理 filename*，只认 filename 字段。哪怕 Postman 发了正确的 filename*=，Multer 也会无视。

Postman Mac版

Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma

下载

必须自定义 storage.filename 函数，从 req.headers 或 req.file.fieldname 关联的原始 part header 中提取
示例关键代码：

const storage = multer.diskStorage({
  filename: (req, file, cb) => {
    const disposition = req.headers['content-disposition'];
    const filenameStarMatch = disposition?.match(/filename\*=(?:UTF-8'')([^;]+)/i);
    const originalName = filenameStarMatch ? decodeURIComponent(filenameStarMatch[1]) : file.originalname;
    cb(null, originalName);
  }
});

注意：decodeURIComponent 要包在 try/catch 里，防止 malformed URI error
别忘了 app.use(multer({ storage }).single('file')) 中的字段名要和前端 form-data 的 key 一致

Postman 上传前必须检查的三件事

很多乱码问题其实卡在客户端配置，而不是后端。

在 Postman 的 Body → form-data 中，Key 类型选 File（不是 Text），然后点右侧 Select Files —— 直接拖入带中文名的文件，不要手动输入文件名
确保文件系统本身支持 UTF-8 文件名（macOS / Linux 默认支持；Windows 需确认当前代码页是 65001，或改用 WSL）
如果用 Pre-request Script 动态设置文件名，请勿调用 pm.request.body.formdata.append() 手动拼 Content-Disposition —— 这会绕过 Postman 内置的 RFC 编码逻辑，大概率出错

最常被忽略的一点：Nginx 或 API 网关（如 Kong、Tyk）可能默认 strip 或 rewrite Content-Disposition 头。如果你的请求经过了中间件，务必检查其日志或抓包确认该 header 是否完整透传到了后端。没有 filename*，后端再怎么修也是白搭。