Docker容器中Blazor .NET应用无法获取NuGet包的JS/CSS文件问题

问题概述 #

将包含公共NuGet包（如BlazorInputMask）的Blazor应用部署到Linux Docker容器时，容器构建无报错，包的DLL文件已正常出现在/app和/src目录，但NuGet包附带的JS文件未被正确部署到容器内对应路径，导致浏览器请求_content/BlazorInputMask/Main.js等文件时返回404。非容器化构建运行时功能正常，问题仅出现在VS生成的默认Dockerfile构建的容器环境中。

复现步骤 #

• 创建带Docker支持的全新Blazor应用
• 添加公共NuGet包（示例：BlazorInputMask）
• 在_Layout.cshtml中添加JS文件引用：

  <script type="text/javascript" src="_content/BlazorInputMask/Main.js"></script>
  <script type="text/javascript" src="_content/BlazorInputMask/IMask.js"></script>
  

• 使用Docker调试器本地运行应用
• 浏览器网络请求中出现404错误，提示Main.js未找到
• 通过VS Docker工具查看容器内文件，wwwroot目录下无Main.js和IMask.js，且_content/BlazorInputMask文件夹不存在

已尝试的无效操作 #

添加了自定义NuGet.config文件，但问题依旧：

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  <add key="wcmMapsSrc" value="." />
</packageSources>

解决方案 #

1. 修正Dockerfile的发布命令 #

VS生成的默认Dockerfile可能在发布阶段未完整提取NuGet包中的静态资源，修改publish阶段的命令，确保包含所有静态资产：

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

添加--no-restore可避免重复还原包，同时确保发布过程完整复制NuGet包内的静态文件到输出目录。

2. 验证项目文件配置 #

确认项目的.csproj文件包含以下配置，确保静态资源处理逻辑正确：

<PropertyGroup>
  <TargetFramework>net7.0</TargetFramework> <!-- 替换为你使用的.NET版本 -->
  <StaticWebAssetBasePath>wwwroot</StaticWebAssetBasePath>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="BlazorInputMask" Version="3.2.0" /> <!-- 替换为实际使用的包版本 -->
</ItemGroup>

3. 检查容器内发布目录 #

发布完成后，进入容器验证静态资源是否存在：

docker exec -it <你的容器ID> bash
ls /app/publish/wwwroot/_content/BlazorInputMask

若目录下存在Main.js和IMask.js，说明资源已正确部署，可检查静态资源中间件配置；若不存在，重新核对Dockerfile的构建步骤。

4. 确保静态资源中间件顺序正确 #

在Program.cs中确认UseStaticFiles()中间件的调用顺序在路由之前：

var builder = WebApplication.CreateBuilder(args);

// 注册服务逻辑...

var app = builder.Build();

// 静态资源中间件必须放在路由配置之前
app.UseStaticFiles();

app.UseRouting();

// 其他中间件配置...

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

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