如何为含跨解决方案ProjectReferences的项目添加Docker支持？

问题背景 #

你的Monorepo目录结构如下：

Monorepo/
├── WebApiSolution/
│   ├── WebApiSolution.sln
│   └── WebApiProject/
│       ├── WebApiProject.csproj
│       └── Dockerfile
├── ...
└── LibsSolution/
    ├── LibsSolution.sln
    ├── LibAProject/
    │   ├── LibAProject.csproj
    │   └── ...
    └── LibBProject/
        ├── LibBProject.csproj
        └── ...

WebApiProject已通过以下方式依赖LibAProject和LibBProject：

• 将类库项目添加至WebApiSolution解决方案
• 在WebApiProject.csproj中添加项目引用：

<!-- WebApiProject.csproj -->
<ItemGroup>
    <ProjectReference Include="..\..\LibsSolution\LibAProject\LibAProject.csproj" />
    <ProjectReference Include="..\..\LibsSolution\LibBProject\LibBProject.csproj" />
</ItemGroup>

尝试通过「Add | Docker Support...」功能添加Dockerfile时，Visual Studio报错：

An error occurred while adding Docker File support to this project.

In order to add Docker support, the solution file (.sln) must be located in the same folder or a higher folder than the target project file and all referenced project files (.csproj, .vbproj).

最佳解决方案 #

方案一：在Monorepo根目录创建统一解决方案（推荐） #

这是最符合Monorepo管理规范的方案，从根源上解决路径问题：

• 在Monorepo/根目录新建解决方案（例如命名为Monorepo.sln）
• 将WebApiProject、LibAProject、LibBProject等所有相关项目添加到这个根解决方案中
• 移除WebApiSolution.sln中的类库项目引用，后续统一使用根解决方案管理所有项目
• 打开根解决方案，重新执行「Add | Docker Support...」操作，此时所有项目路径都在解决方案目录范围内，可正常生成Dockerfile

方案二：为WebApiSolution添加解决方案文件夹 #

如果不想调整根目录结构，可通过解决方案文件夹让Visual Studio识别合法的路径关系：

• 打开WebApiSolution.sln，右键解决方案 → 添加 → 解决方案文件夹，命名为Libs
• 右键Libs文件夹 → 添加 → 现有项目，选择LibsSolution/LibAProject/LibAProject.csproj和LibsSolution/LibBProject/LibBProject.csproj
• 此时解决方案会正确识别类库项目的相对路径，满足Docker工具的路径要求，重新执行添加Docker Support操作即可

方案三：手动创建Dockerfile（应急方案） #

若暂时无法调整解决方案结构，可手动编写Dockerfile替代Visual Studio的自动生成功能：

1. 在WebApiProject目录下新建Dockerfile文件，填入以下示例内容（以.NET 6为例，可根据你的框架版本调整）：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApiSolution/WebApiProject/WebApiProject.csproj", "WebApiSolution/WebApiProject/"]
COPY ["LibsSolution/LibAProject/LibAProject.csproj", "LibsSolution/LibAProject/"]
COPY ["LibsSolution/LibBProject/LibBProject.csproj", "LibsSolution/LibBProject/"]
RUN dotnet restore "WebApiSolution/WebApiProject/WebApiProject.csproj"
COPY . .
WORKDIR "/src/WebApiSolution/WebApiProject"
RUN dotnet build "WebApiProject.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApiProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApiProject.dll"]

2. 在Visual Studio中右键WebApiProject → 添加 → 现有项，选择刚创建的Dockerfile，即可正常使用Docker相关工具

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