.NET 6 Docker容器内构建耗时长、内存超16GB解决方案

构建耗时过长、内存占用超16G由几个典型配置错误直接导致：

• 缺失.dockerignore文件：构建时会将本地bin/obj编译缓存、.git目录、开发配置、日志等无关文件全量传入构建上下文，不仅文件传输耗时，还会触发dotnet编译过程的异常文件扫描，直接拉满内存。
• 镜像标签使用错误：带/core/后缀的.NET镜像为兼容旧版本保留的过渡标签，拉取速度慢、层缓存失效概率高，不适合.NET 6及以上版本使用。
• 未配置缓存：没有利用Docker层缓存、NuGet包缓存机制，每次构建都会重复下载全量依赖、执行重复编译步骤。
• Docker Desktop无资源限制：Windows上WSL2后端默认无内存上限，构建进程可无限制占用宿主内存。

1. 先创建.dockerignore文件 #

在Dockerfile同级目录新建.dockerignore文件，过滤无关文件，从根源缩小构建上下文体积：

**/.git
**/.gitignore
**/bin
**/obj
**/.vs
**/.vscode
**/node_modules
**/*.user
**/appsettings.Development.json
**/TestResults
**/*.log
**/docker-compose*.yml
**/Dockerfile*

注意：不要把Dockerfile放在磁盘根目录，否则构建会扫描整个磁盘的文件，直接触发内存占满问题。

2. 修正Dockerfile内容 #

替换为以下优化后的配置，修正镜像源、增加缓存挂载、跳过重复编译步骤：

# 构建阶段：使用官方正式版SDK镜像，弃用过时的/core/路径标签
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build-env
WORKDIR /src

# 仅拷贝项目文件，利用Docker层缓存，代码修改不会触发重复依赖还原
COPY *.csproj ./
# 挂载NuGet缓存目录，首次构建后依赖会持久化缓存，无需每次重新下载
RUN --mount=type=cache,target=/root/.nuget/packages \
    dotnet restore

# 拷贝剩余代码，执行Release编译，跳过已完成的restore步骤
COPY . ./
RUN dotnet build -c Release --no-restore

# 执行发布，关闭调试文件输出，跳过已完成的build步骤，减小产物体积
RUN dotnet publish -c Release -o out --no-build /p:DebugType=None /p:DebugSymbols=false

# 运行时阶段：使用精简版ASP.NET运行时镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0
WORKDIR /app
# 仅拷贝构建阶段产出的发布文件，不引入任何编译时多余文件
COPY --from=build-env /src/out .
# 配置应用监听端口，避免新版镜像默认端口不匹配问题
ENV ASPNETCORE_URLS=http://+:80
EXPOSE 80
# 注意：将下方dll名替换为你自己项目实际生成的dll文件名
ENTRYPOINT ["dotnet", "docker-guide.dll"]

3. 调整Windows Docker Desktop配置 #

如果你使用WSL2后端（性能比Hyper-V后端高50%以上，推荐启用），需要配置WSL资源限制避免内存泄漏：

1. 打开Windows用户目录（一般路径为C:\Users\你的Windows用户名），新建名为.wslconfig的文件，写入以下配置：

[wsl2]
memory=8GB
processors=4
swap=2GB

2. 打开PowerShell执行wsl --shutdown关闭WSL实例，重启Docker Desktop后配置生效。
3. 打开Docker Desktop设置 -> Resources -> File Sharing，仅勾选你存放项目的磁盘分区，不要全部分区都勾选，减少跨系统文件共享开销。

4. 执行构建 #

在Dockerfile所在目录执行构建命令即可：

docker build -t dotnet6-app .

• 如果你的解决方案包含多个类库项目，不要用COPY *.csproj ./的写法，需要按照项目依赖层级依次拷贝所有项目的csproj文件，才能保证层缓存生效，避免每次构建都全量还原。
• 如果构建时需要排查卡顿点，可以在构建命令后加--progress=plain参数，查看每一步的执行日志定位耗时环节。

内容的提问来源于stack exchange，提问作者Gustavo Rocha Dias