如何为带集成API的ASP.NET Core托管BlazorWasm编写单容器部署Dockerfile

托管模式Blazor WASM的原生架构本身就是单进程同时承载后端API、客户端静态资源，和本地IIS Express调试时同端口运行的逻辑完全一致，单容器部署不存在技术障碍。VS2019 16.8.3版本没有内置Blazor WASM的Docker支持不影响落地，完全可以通过手动编写Dockerfile完成部署，不需要依赖IDE的自动生成功能。

前置项目结构确认 #

• 标准托管Blazor WASM解决方案一般包含三个独立项目：ASP.NET Core宿主项目（Server，承载API控制器、静态资源中间件）、Blazor WASM客户端项目（Client，前端交互逻辑）、共享类库（Shared，前后端通用模型、接口定义）
• 原生dotnet publish发布Server项目时，MSBuild会自动触发Client项目编译，将所有前端静态资源输出到Server发布目录的wwwroot文件夹，最终生成的发布产物就是可独立运行的单个Web应用，和之前拆分部署的产物没有本质区别，只是整合在了同一进程内
• 不需要为了容器部署修改现有业务代码，之前拆分部署时的API逻辑、前端逻辑可以完全复用

适配场景的Dockerfile编写 #

直接将以下内容保存为解决方案根目录（即存放.sln文件的目录）下的Dockerfile，不需要放到单个项目目录中适配IDE的自动检测逻辑：

# 构建阶段：使用和项目目标框架匹配的.NET SDK镜像，如.NET Core 3.1就替换为3.1-sdk标签
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /src

# 利用Docker层缓存，先拷贝项目文件还原依赖
COPY *.sln .
COPY BlazorApp.Server/*.csproj BlazorApp.Server/
COPY BlazorApp.Client/*.csproj BlazorApp.Client/
COPY BlazorApp.Shared/*.csproj BlazorApp.Shared/
RUN dotnet restore

# 拷贝全量源码，发布Server项目
COPY . .
WORKDIR /src/BlazorApp.Server
RUN dotnet publish -c Release -o /app/published --no-restore

# 运行阶段：使用轻量的ASP.NET Core运行时镜像，标签版本和SDK阶段保持一致
FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS runtime
WORKDIR /app
# 拷贝构建阶段的发布产物
COPY --from=build /app/published .

EXPOSE 80
# 强制应用监听容器内所有网络接口，避免外部请求无法到达
ENV ASPNETCORE_URLS=http://+:80
ENTRYPOINT ["dotnet", "BlazorApp.Server.dll"]

核心逻辑说明 #

• 全程没有对前后端做额外拆分，最终容器内运行的就是整合了前端静态资源的宿主应用，和本地调试时的运行形态完全一致
• 整个构建流程完全不依赖VS2019的Docker支持功能，只要本地能正常执行dotnet发布命令，Docker构建就能正常完成，不受IDE版本限制
• 采用多阶段构建，最终运行的镜像只有轻量的运行时环境，没有SDK、编译缓存这些冗余内容，镜像体积更小

基础部署操作 #

• 在解决方案根目录打开命令行，执行构建命令：docker build -t blazor-wasm-single-container .
• 构建完成后启动容器，做本地端口映射：docker run -d -p 8080:80 blazor-wasm-single-container
• 访问映射的本地8080端口，就能同时访问前端页面和后端API，和本地调试时的体验完全一致

常见避坑提示 #

• 不需要手动将Client项目的产物单独拷贝到容器中，原生发布流程已经自动完成整合，手动拷贝反而会出现静态资源路径错位、资源404的问题
• 镜像的SDK、运行时标签必须和项目的目标框架严格匹配，避免出现运行时版本不兼容的报错
• 如果应用需要配置HTTPS、自定义端口，只需要调整ASPNETCORE_URLS环境变量的取值，对应修改容器的端口映射规则即可

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