.Net-Docker项目重构时出现UnicodeDecodeError问题求助

• 排查文件编码的深层问题
  不要仅依赖记事本，用VS Code、Notepad++等专业工具打开可疑文件（如Dockerfile、项目配置文件、构建脚本），查看工具右下角显示的实际编码。0xfd是UTF-16LE的BOM字节，大概率是文件实际为UTF-16编码却被当作UTF-8解析。转编码时选择「转为UTF-8无BOM格式」，带BOM的UTF-8在Linux环境下易触发解码错误。

• 检查Docker构建上下文的文件
  确认Docker构建时COPY/ADD指令涉及的所有文件，重点排查重构后新增或修改的文件：

  • 项目的.csproj、.sln文件
  • docker-compose.yml及相关构建脚本
  • 避免将二进制文件误纳入构建上下文，这类文件会被当成文本文件处理引发编码错误。

• 调整.Net项目的编码配置
  在项目的.csproj文件中添加编码强制配置：

  <PropertyGroup>
    <LangVersion>latest</LangVersion>
    <DefaultItemEncoding>utf-8</DefaultItemEncoding>
  </PropertyGroup>
  

  同时在Dockerfile中添加环境变量，确保构建过程使用UTF-8编码：

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

• 检查Docker镜像的基础环境
  若使用自定义基础镜像，需确保环境支持UTF-8编码，可在Dockerfile中添加语言包安装命令：

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

  优先使用官方提供的.Net镜像（如mcr.microsoft.com/dotnet/aspnet:8.0），这类镜像默认已配置好UTF-8环境。

内容的提问来源于stack exchange，提问作者c_atlantis