ASP.NET Core MVC俄文文件名Docker容器部署异常解决方案咨询

我有一个ASP.NET Core MVC应用，wwwroot目录下存在俄文文件名的文件。将其复制到Docker容器后，文件名显示异常，且在dotnet publish阶段出现错误：

error MSB3030: Could not copy the file "/src/src/VL_APP.Web.Mvc/wwwroot/**" because it was not found.

推测是容器内文件路径识别错误导致的。虽然可以将文件重命名为英文并修改代码适配，但需要保留俄文文件名。此前尝试在Dockerfile中配置本地化未成功：

RUN apt-get install -y locales
RUN locale-gen en_US.UTF-8

1. 完善容器本地化配置（关键步骤） #

之前的配置仅生成了en_US.UTF-8 locale，但未设置系统默认编码为UTF-8，导致容器无法识别俄文（西里尔字母）文件名。修改Dockerfile如下：

# 更新源并安装本地化工具
RUN apt-get update && apt-get install -y --no-install-recommends locales

# 生成UTF-8编码的英文和俄文本地化规则
RUN locale-gen en_US.UTF-8 ru_RU.UTF-8

# 设置系统默认编码为UTF-8
ENV LANG=en_US.UTF-8
ENV LC_ALL=en_US.UTF-8
ENV LC_CTYPE=en_US.UTF-8

注：使用en_US.UTF-8即可兼容俄文文件名，无需强制切换为ru_RU.UTF-8，只要系统编码为UTF-8就能正确解析西里尔字符。

2. 强制MSBuild使用UTF-8处理文件路径 #

在ASP.NET Core项目的.csproj文件中添加以下配置，确保MSBuild在编译和发布时用UTF-8编码识别文件路径：

<PropertyGroup>
  <!-- 设置默认项编码为UTF-8 -->
  <DefaultItemEncoding>utf-8</DefaultItemEncoding>
  <!-- 确保MSBuild使用UTF-8解析文件名 -->
  <MSBuildFileSystemEncoding>utf-8</MSBuildFileSystemEncoding>
</PropertyGroup>

或者在dotnet publish命令中直接指定编码参数：

dotnet publish -c Release /p:DefaultItemEncoding=utf-8 /p:MSBuildFileSystemEncoding=utf-8

3. 验证容器内编码环境 #

构建并运行容器后，进入容器执行locale命令，确认输出如下（确保所有LC_*项均为UTF-8）：

LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=en_US.UTF-8

4. 确保文件复制环节编码一致 #

• 宿主系统中，确保俄文文件名以UTF-8编码存储（Windows系统需注意，默认可能是GBK或UTF-16，可通过命令行或工具转换为UTF-8编码的文件名）。
• Dockerfile中使用COPY命令时，避免使用过于宽泛的通配符（如**），可明确指定目录：

COPY src/VL_APP.Web.Mvc/wwwroot/ /app/wwwroot/

内容的提问来源于stack exchange，提问作者A.K.A.MAGARICH