.NET Core 7 MVC项目Docker部署时wwwroot子文件夹未完整发布问题

我有一个小型.NET Core 7 MVC项目，部署到Docker后可正常运行，但发现wwwroot文件夹仅部分发布。通过npm和webpack生成的JS、CSS文件所在的dist文件夹，以及wwwroot根目录下的offline.html、serviceworker均可正常访问，但wwwroot下的其他子文件夹（如图片文件夹）未被发布。已在program.cs中于app.UseRouting()前添加app.UseStaticFiles()，相关配置如下：

Dockerfile原配置 #

WORKDIR /app
EXPOSE 80
EXPOSE 443


FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["MyProject/MyProject.csproj", "MyProject/"]
RUN dotnet restore "MyProject/MyProject.csproj"
COPY . .

WORKDIR "/src/MyProject"
RUN dotnet build "MyProject.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "MyProject.csproj" -c Release -o /app/publish
WORKDIR /app/publish

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

csproj原配置 #

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
    <IsPackable>false</IsPackable>
    <MpaRoot>npm\</MpaRoot>
    <WWWRoot>wwwroot\</WWWRoot>
    <DefaultItemExcludes>$(DefaultItemExcludes);$(MpaRoot)node_modules\**</DefaultItemExcludes>

  </PropertyGroup>

  <!--<ItemGroup>
    <Content Include="npm\src\css\site.css" />
  </ItemGroup>-->

  <ItemGroup>
    <PackageReference Include="Dapper" Version="2.0.123" />
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="7.0.2" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="7.0.2" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="7.0.2" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="7.0.2" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="7.0.2">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="7.0.3" />
  </ItemGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.SpaServices.Extensions" Version="7.0.2" />
  </ItemGroup>

  <ItemGroup>
    <!-- Don't publish the MPA source files, but do show them in the project files list -->
    <Content Remove="$(MpaRoot)**" />
    <None Remove="$(MpaRoot)**" />
    <None Include="$(MpaRoot)**" Exclude="$(MpaRoot)node_modules\**" />
  </ItemGroup>   
</Project>

问题排查与解决方案 #

1. 修正Dockerfile基础镜像缺失问题 #

原Dockerfile开头缺少运行时基础镜像定义，导致FROM base AS final无法找到依赖镜像，可能引发发布文件复制异常。修正后的Dockerfile如下：

# 运行时基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["MyProject/MyProject.csproj", "MyProject/"]
RUN dotnet restore "MyProject/MyProject.csproj"
COPY . .

WORKDIR "/src/MyProject"
RUN dotnet build "MyProject.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "MyProject.csproj" -c Release -o /app/publish

# 最终镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyProject.dll"]

2. 确保wwwroot子文件夹被标记为项目内容 #

.NET Core默认会将wwwroot下的Content类型文件纳入发布范围，但手动创建的子文件夹（如图片文件夹）可能未被自动添加到项目配置中。可通过两种方式处理：

• 在Visual Studio中右键目标文件夹→包含在项目中
• 直接在csproj中添加明确的包含规则：

  <ItemGroup>
    <!-- 包含wwwroot下所有文件，排除已由webpack处理的dist文件夹避免重复 -->
    <Content Include="wwwroot/**/*" Exclude="wwwroot/dist/**/*" />
  </ItemGroup>
  

3. 验证本地发布结果 #

先在本地执行发布命令，检查输出目录是否包含缺失的子文件夹：

dotnet publish -c Release

查看bin/Release/net7.0/publish/wwwroot目录，若本地发布就缺失，说明是项目配置问题；若本地正常，再检查Docker构建时的文件复制环节。

4. 排查Docker构建时的文件复制 #

可在Dockerfile的COPY . .步骤后添加校验命令，确认构建环境中wwwroot的内容：

COPY . .
# 查看wwwroot目录结构
RUN ls -la /src/MyProject/wwwroot

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