Docker部署.NET应用后静态资源（CSS/JS）缺失问题求助

问题说明 #

将.NET应用通过Docker容器化部署后，出现静态资源（CSS、JS文件）无法加载的情况，已在Program.cs中配置app.UseStaticFiles();。

现有配置 #

Docker Compose文件 #

my-app:
  image: my-app-img
  container_name: my-app
  restart: always
  ports:
    - "80:80"

Dockerfile #

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /MyApp

COPY . ./

FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /MyApp
COPY --from=build-env /MyApp/out .
ENTRYPOINT ["dotnet", "MyApp.WebUI.dll']

布局页面资源链接 #

<script src="~/lib/jquery/dist/jquery-3.2.1.slim.min.js"></script>
<script src="~/lib/popper.min.js"></script>
<script src="~/lib/bootstrap/dist/js/bootstrap.min.js"></script>
<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/js/site.js" asp-append-version="true"></script>

排查与解决方法 #

1. 补全Dockerfile的发布步骤 #

当前Dockerfile仅复制了代码但未执行发布命令，导致静态资源未被打包到输出目录。修改Dockerfile，添加发布指令：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /MyApp

COPY . ./
# 执行发布命令，根据项目结构调整WebUI项目路径
RUN dotnet publish MyApp.WebUI/MyApp.WebUI.csproj -c Release -o out

FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /MyApp
COPY --from=build-env /MyApp/out .
ENTRYPOINT ["dotnet", "MyApp.WebUI.dll"]

若WebUI项目在根目录，直接使用dotnet publish -c Release -o out即可。

2. 确认项目文件对静态资源的配置 #

检查Web项目的.csproj文件，确保wwwroot下的静态资源会被复制到输出目录：

<ItemGroup>
  <Content Update="wwwroot/**/*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <PublishCopyToOutputDirectory>PreserveNewest</PublishCopyToOutputDirectory>
  </Content>
</ItemGroup>

3. 验证容器内静态资源是否存在 #

进入容器查看wwwroot目录是否包含所需文件：

docker exec -it my-app ls /MyApp/wwwroot

如果目录为空，说明发布过程未正确复制资源，回到前两步排查。

4. 确认静态资源路径配置 #

• 若应用部署在子路径下，需调整UseStaticFiles的路径配置：

app.UseStaticFiles(new StaticFileOptions
{
    RequestPath = "/你的应用子路径"
});

• 建议在视图中使用标签助手确保路径正确，需先在视图顶部添加：

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

然后修改资源链接：

<script src="~/lib/jquery/dist/jquery-3.2.1.slim.min.js" asp-append-version="true"></script>

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