Docker：利用单一构建工件为多镜像共享.NET依赖DLL

方案一：构建共享基础镜像 #

专门创建一个镜像来编译共享DLL，其他项目的Dockerfile直接引用这个镜像的构建结果，彻底避免重复编译。

步骤： #

1. 编写用于构建共享DLL的Dockerfile（命名为Dockerfile.shared）：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build-shared
WORKDIR /src
# 先复制项目文件做分层缓存，加快后续构建
COPY SharedLibrary/SharedLibrary.csproj ./SharedLibrary/
RUN dotnet restore ./SharedLibrary/SharedLibrary.csproj
# 复制完整代码并构建发布共享DLL
COPY SharedLibrary/ ./SharedLibrary/
RUN dotnet build ./SharedLibrary/SharedLibrary.csproj -c Release -o /app/shared

2. 构建这个共享镜像：

docker build -f Dockerfile.shared -t shared-dll-build:latest .

3. 在项目A、B的Dockerfile中引入该镜像：

# 项目A的Dockerfile
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
# 从共享镜像中拷贝已构建好的DLL
COPY --from=shared-dll-build /app/shared /app/shared
WORKDIR /src
COPY ProjectA/ProjectA.csproj ./ProjectA/
# 还原时指定共享DLL的目录作为依赖源
RUN dotnet restore ./ProjectA/ProjectA.csproj --source /app/shared
COPY ProjectA/ ./ProjectA/
RUN dotnet build ./ProjectA/ProjectA.csproj -c Release -o /app/build

# 发布阶段（按需调整）
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY --from=build /app/build .
ENTRYPOINT ["dotnet", "ProjectA.dll"]

方案二：用Docker BuildKit缓存挂载 #

如果不想单独维护共享镜像，可以借助BuildKit的缓存功能，让多个项目构建时复用同一个缓存目录里的共享DLL构建结果。

实现示例： #

在项目A、B的Dockerfile中加入缓存挂载逻辑（注意要启用BuildKit）：

# syntax=docker/dockerfile:1.4  # 声明使用BuildKit语法
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
# 挂载缓存目录，检查是否已有构建好的DLL，没有则构建
RUN --mount=type=cache,target=/app/shared \
    if [ ! -f /app/shared/SharedLibrary.dll ]; then \
        cp -r ../SharedLibrary ./ && \
        dotnet build ./SharedLibrary/SharedLibrary.csproj -c Release -o /app/shared; \
    fi
# 复制项目文件并还原，依赖缓存中的共享DLL
COPY ProjectA/ProjectA.csproj ./ProjectA/
RUN dotnet restore ./ProjectA/ProjectA.csproj --source /app/shared
COPY ProjectA/ ./ProjectA/
RUN dotnet build ./ProjectA/ProjectA.csproj -c Release -o /app/build

# 后续发布阶段...

构建时需要启用BuildKit：

DOCKER_BUILDKIT=1 docker build -t project-a:latest .

第一次构建时会编译共享DLL并存入缓存，后续项目A、B的构建都会直接复用缓存中的结果。

方案三：打包为本地NuGet包 #

把共享DLL打包成本地NuGet包，让两个项目从本地NuGet源获取依赖，避免重复编译。

步骤： #

1. 在共享DLL项目目录执行打包命令：

dotnet pack -c Release -o ./nuget

2. 在项目A、B的Dockerfile中引入本地NuGet源：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
# 拷贝本地NuGet包目录
COPY ../SharedLibrary/nuget /nuget
# 添加本地源到NuGet配置
RUN dotnet nuget add source /nuget --name local-shared
# 还原项目依赖（会自动从本地源拉取共享DLL）
COPY ProjectA/ProjectA.csproj ./ProjectA/
RUN dotnet restore ./ProjectA/ProjectA.csproj
COPY ProjectA/ ./ProjectA/
RUN dotnet build ./ProjectA/ProjectA.csproj -c Release -o /app/build

# 后续发布阶段...

方案选择建议 #

• 如果多个项目需要长期稳定复用共享DLL，优先选方案一，基础镜像的方式更可控；
• 如果只是临时或频繁构建场景，方案二的缓存挂载更轻便；
• 若团队本身有NuGet包管理习惯，方案三更贴合现有流程。

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