使用Docker时如何组织.NET项目？共享类库引用问题咨询

核心问题是Docker默认的构建上下文范围限制：当你在service1目录下执行docker build时，Docker只能访问service1内部的文件，上级的Shared文件夹不在构建上下文里，导致无法引用。下面是两种可靠的解决方法：

方法一：从根目录指定Dockerfile构建（推荐） #

这是最通用、跨平台的解决方案，步骤如下：

1. 打开终端，进入项目根目录my-system
2. 执行构建命令，指定Dockerfile的路径：

   # 构建service1的镜像
   docker build -t service1-api -f service1/Dockerfile .
   # 构建service2的镜像
   docker build -t service2-api -f service2/Dockerfile .
   

3. 修改service1/Dockerfile里的文件复制路径，适配根目录作为构建上下文的情况：

   # 基础运行镜像
   FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
   WORKDIR /app
   EXPOSE 80
   
   # 构建阶段
   FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
   WORKDIR /src
   
   # 先复制项目文件以利用Docker缓存
   COPY ["Shared/Shared.csproj", "Shared/"]
   COPY ["service1/service1.API/service1.API.csproj", "service1/service1.API/"]
   # 恢复项目依赖（包括Shared类库）
   RUN dotnet restore "service1/service1.API/service1.API.csproj"
   
   # 复制所有项目代码
   COPY . .
   WORKDIR "/src/service1/service1.API"
   RUN dotnet build "service1.API.csproj" -c Release -o /app/build
   
   # 发布阶段
   FROM build AS publish
   RUN dotnet publish "service1.API.csproj" -c Release -o /app/publish /p:UseAppHost=false
   
   # 最终镜像
   FROM base AS final
   WORKDIR /app
   COPY --from=publish /app/publish .
   ENTRYPOINT ["dotnet", "service1.API.dll"]
   

   同理修改service2/Dockerfile里的路径，把service1替换成service2即可。

方法二：使用符号链接（不推荐，跨平台兼容性差） #

如果坚持要在service1目录下直接构建，可以在service1目录里创建指向../Shared的符号链接：

• Linux/macOS终端执行：

  cd service1
  ln -s ../Shared Shared
  

• Windows命令提示符执行：

  cd service1
  mklink /D Shared ..\Shared
  

然后修改Dockerfile里的复制路径，把../Shared换成./Shared，但这种方法在Windows和Linux环境下需要分别处理，而且部分Docker环境可能无法正确解析符号链接，容易出问题。

额外检查 #

确保你的service1.API.csproj里已经正确引用了Shared类库，引用路径应该是相对根目录的正确路径，比如：

<ItemGroup>
  <ProjectReference Include="..\..\Shared\Shared.csproj" />
</ItemGroup>

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