Blazor WebAssembly项目Docker镜像构建失败：共享项目引用缺失

你遇到的错误核心是Docker构建上下文缺失依赖项目文件：

• 本地开发时，dotnet watch能访问到上级目录的CNCCentral.Client.Shared和CNCCentral.Shared项目，所以编译正常。
• 但你的Dockerfile只复制了CNCCentral.Client.Web.csproj到容器内，没有把依赖的两个类库项目文件复制进去，容器内的目录结构和本地不一致，导致dotnet restore/publish找不到引用的项目文件。

根据你的项目结构，推荐两种标准修复方式：

方式一：从解决方案根目录构建（更规范） #

假设你的解决方案目录结构如下：

CNCCentral/
├── CNCCentral.sln
├── CNCCentral.Shared/
│   └── CNCCentral.Shared.csproj
├── CNCCentral.Server.Api/
│   └── CNCCentral.Server.Api.csproj
├── CNCCentral.Client.Shared/
│   └── CNCCentral.Client.Shared.csproj
└── CNCCentral.Client.Web/
    ├── Dockerfile
    ├── nginx.conf
    └── CNCCentral.Client.Web.csproj

修改CNCCentral.Client.Web/Dockerfile为：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /app

# 复制解决方案文件（如果存在）
COPY CNCCentral.sln .

# 复制所有依赖项目的csproj到对应目录，保持结构一致
COPY CNCCentral.Shared/CNCCentral.Shared.csproj CNCCentral.Shared/
COPY CNCCentral.Client.Shared/CNCCentral.Client.Shared.csproj CNCCentral.Client.Shared/
COPY CNCCentral.Client.Web/CNCCentral.Client.Web.csproj CNCCentral.Client.Web/

# 针对前端项目执行restore，此时能找到所有引用
RUN dotnet restore CNCCentral.Client.Web/CNCCentral.Client.Web.csproj

# 复制所有项目的源代码文件
COPY . .

# 发布Blazor WASM项目到指定目录
RUN dotnet publish CNCCentral.Client.Web/CNCCentral.Client.Web.csproj -c Release -o /app/publish

FROM nginx:alpine AS final
WORKDIR /usr/share/nginx/html
COPY --from=build /app/publish/wwwroot .
# 从上下文路径复制nginx配置文件
COPY CNCCentral.Client.Web/nginx.conf /etc/nginx/nginx.conf

然后在解决方案根目录执行构建命令：

docker build -t cnccentralclientweb:dev -f CNCCentral.Client.Web/Dockerfile .

方式二：从前端项目目录直接构建 #

如果坚持在CNCCentral.Client.Web目录执行构建，需要调整Dockerfile，手动复制上级目录的依赖项目：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /app

# 创建和本地匹配的目录结构，对应本地的上级目录项目
RUN mkdir -p CNCCentral.Shared
RUN mkdir -p CNCCentral.Client.Shared

# 复制当前项目和依赖项目的csproj文件
COPY CNCCentral.Client.Web.csproj .
COPY ../CNCCentral.Shared/CNCCentral.Shared.csproj CNCCentral.Shared/
COPY ../CNCCentral.Client.Shared/CNCCentral.Client.Shared.csproj CNCCentral.Client.Shared/

# 执行restore，此时容器内的目录结构和本地引用路径匹配
RUN dotnet restore CNCCentral.Client.Web.csproj

# 复制所有项目的源代码
COPY . .
COPY ../CNCCentral.Shared ./CNCCentral.Shared
COPY ../CNCCentral.Client.Shared ./CNCCentral.Client.Shared

# 发布项目
RUN dotnet publish CNCCentral.Client.Web.csproj -c Release -o /app/publish

FROM nginx:alpine AS final
WORKDIR /usr/share/nginx/html
COPY --from=build /app/publish/wwwroot .
COPY nginx.conf /etc/nginx/nginx.conf

然后在CNCCentral.Client.Web目录执行：

docker build -t cnccentralclientweb:dev .

• Docker构建时，只有构建上下文目录及其子目录的文件能被复制到容器，所以必须确保所有依赖项目的文件都被包含在上下文内，或者通过正确的路径复制。
• 保持容器内的项目目录结构和本地一致，这样dotnet命令才能正确解析项目引用路径。

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