NestJS 上传文件中文名乱码

问题

服务端使用的是NestJS,在处理上传需求的时候,发现multipart/form-data上传文件的文件名是中文时,服务器读取到的是乱码

英文是正常的,中文是乱码的

定位问题

环境

  • Node: 22.14.0
  • NetsJS: 10.4.2

Express 的 Multer 包。

代码排查

由于上传文件使用的是 Multer ,因此找到了 Github 上面 Multer 的代码仓库,然后在 Issues 中搜索,发现了类似的情况:

Issue with UTF-8 characters in filename · Issue #1104 · expressjs/multer (github.com)

这个 issue 中提到了另一个包 busboy,Multer 就是通过这个包来解析 FormData 的,原来是这个 busboy 的问题,在该仓库的 Issues 中也能发现有人提了这个问题:

Parsing fails if filename contains UTF-8 characters · Issue #20 · mscdex/busboy (github.com)

busboy 将配置项defParamCharset的默认值从utf8改为了latin1,从而导致了这个问题(居然是一个 patch 更新导致很多人的代码出问题了然后就被指责了),需要手动设置一下。问题是这个 busboy 是由 Multer 负责创建的,同时 Multer 并没有提供defParamCharset这个选项,更别说在内部使用了 Multer 的 NestJS 了。

解决问题

目前 issue 中提供的方法和搜索引擎中提供的方法是类似的:

ts 复制代码
file.originalname = Buffer.from(file.originalname, 'latin1').toString('utf8');

在 NestJS 中,我们可以自定义一个管道 Pipe 来处理这个问题。

首先定义一个管道common/pips/file-name-encode.pipe.ts

ts 复制代码
import { PipeTransform, Injectable, ArgumentMetadata } from '@nestjs/common';  
  
@Injectable()  
export class FileNameEncodePipe implements PipeTransform {  
transform(value: Express.Multer.File, metadata: ArgumentMetadata) {  
if (!/[^\u0000-\u00ff]/.test(value.originalname)) {  
value.originalname = Buffer.from(value.originalname, 'latin1').toString(  
'utf8',  
);  
}  
return value;  
}  
}

然后在controller就可以用了

ts 复制代码
import { FileNameEncodePipe } from '@/common/pipes/file-name-encode.pipe';

async uploadFile(
    @UploadedFile(
      new FileNameEncodePipe(),
      new ParseFilePipe({
        validators: [
          new MaxFileSizeValidator({ maxSize: 30 * 1024 * 1024 }),
          new FileTypeValidator({ fileType: 'application/pdf' }),
        ],
      }),
    )
    file: Express.Multer.File,
  ) {
    return this.uploadService.handleFileUpload(file);
  }

这里是对原文件名进行一个正则判断,如果原来的文件名可以通过latin1方式正确解码出来,就不处理。

至此,浏览器和 Apifox 测试都正常了。

相关推荐
CoderYanger11 分钟前
Java EE 进阶:10. MyBatis-Plus使用(第一弹)
java·spring boot·后端·sql·spring·java-ee·mybatis
一条Go1 小时前
状态页与 SLA:对外承诺是怎么算出来的
后端·架构·github
喵个咪1 小时前
GoWind IM 场景:乙方怎么用一套 IM 平台交付多个客户——档位、租户与离线交付
后端·go·saas
大胖爱学习_MJ2 小时前
超越向量检索:用 Spring Boot + Neo4j 手搓 GraphRAG 知识图谱记忆
java·后端·python
知识搬运临时工3 小时前
双路服务器跑得比单路慢:JVM 没看见内存的距离
java·后端
Gopher_HBo3 小时前
mprof.go全程跟拍-跟着一个请求走完四种采集
后端
tong_li3 小时前
给娃做个 AI 陪写作业助手:LangChain4j 入门(三):配本古诗书(RAG 入门),答得不瞎编
后端
用户48678952533904 小时前
多租户第二集:读隔离做完之后,写路径才是真坑
后端
bai2734 小时前
同一个 1.005,toFixed 给 1.00、Math.round 给 1、Intl 给 1.01:999 个三分位小数的实测
javascript·后端
千寻技术帮4 小时前
基于Spring Boot+Vue的农产品销售管理系统(源码+文档+数据库,附部署教程)
java·数据库·spring boot·后端·mysql·vue