Docker环境下express-fileupload上传文件名编码错误问题咨询

该乱码问题和接口响应头配置无关，content-type: application/json; charset=utf-8仅控制接口返回内容的编码，不影响multipart请求解析阶段的文件名解码。
本地运行正常、Docker环境乱码的核心原因是Docker容器默认locale未配置为UTF-8，配合express-fileupload未显式指定解码字符集，导致文件名解析时 fallback 到系统非UTF-8字符集出现乱码。同一请求内JSON内容正常，是因为JSON字段解析逻辑直接按HTTP头声明的编码处理二进制流，不依赖系统locale配置。

Node.js本身没有全局统一的编码配置：核心API默认大多使用UTF-8，涉及系统交互的场景会读取LANG、LC_ALL环境变量获取系统字符集；第三方依赖包如果未显式传参指定编码，也会默认读取上述环境变量作为解码依据。

按顺序操作即可：

1. 修正Docker容器的locale配置 #

首先进入运行中的容器执行以下命令验证当前locale：

locale

如果输出中LANG、LC_ALL字段值为POSIX、C而非UTF-8编码，先在Dockerfile中添加全局环境变量配置，绝大多数Debian、Ubuntu、Alpine基础镜像都自带C.UTF-8支持，不需要额外安装依赖：

ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8

如果使用精简版Alpine镜像未内置C.UTF-8，先安装locale相关包再配置：

RUN apk add --no-cache musl-locales musl-locales-lang
ENV LANG=zh_CN.UTF-8
ENV LC_ALL=zh_CN.UTF-8

重新构建镜像后即可让容器默认字符集为UTF-8。

2. 显式指定express-fileupload的解码编码 #

从代码层面锁死解析编码，彻底避免环境差异带来的问题，在初始化express-fileupload中间件时添加两个编码配置项：

const fileUpload = require('express-fileupload');
app.use(fileUpload({
  defCharset: 'utf8',
  // 该参数专门控制multipart表单内文件名、普通字段名的解码字符集，需express-fileupload@1.4.0及以上版本支持
  defParamCharset: 'utf8'
}))

如果当前使用的express-fileupload版本低于1.4.0，先升级包版本即可。

3. 反向代理排查（可选） #

如果上述两步操作后仍存在乱码，检查部署链路中的反向代理层（Nginx、K8s Ingress等），确认代理层未对multipart请求头做额外转码操作。

内容的提问来源于stack exchange，提问作者F.H.