使用LibMan时Razor类库静态Web资产本地与发布后URL不一致问题

问题根源 #

Microsoft.Web.LibraryManager.Build任务在构建时，若配置不当会将RCL（JoinRpg.WebComponents）中的静态资产直接复制到主项目（JoinRpg.Portal）的wwwroot目录，而非保留RCL静态资产的/_content/前缀结构。本地开发时ASP.NET Core会同时加载RCL的/_content/路径和主项目wwwroot，因此显示正确路径；但Docker发布后，主项目wwwroot中的资产被优先加载，导致路径变为/lib/...。

解决方案 #

1. 修正RCL的Library Manager配置 #

确保RCL的libman.json将资产安装到自身的wwwroot目录，保留完整的静态资产结构：

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": [
    {
      "library": "bootstrap-select@1.13.18",
      "destination": "wwwroot/lib/bootstrap-select",
      "files": [
        "js/bootstrap-select.js"
      ]
    }
  ]
}

同时检查RCL的.csproj文件，避免添加将资产复制到主项目wwwroot的额外配置（如CopyToOutputDirectory或CopyToPublishDirectory）。

2. 禁用主项目的RCL资产合并 #

在主项目（JoinRpg.Portal）的.csproj中添加以下配置，强制ASP.NET Core始终通过/_content/JoinRpg.WebComponents/路径访问RCL静态资产：

<PropertyGroup>
  <StaticWebAssetsMergeRCLAssets>false</StaticWebAssetsMergeRCLAssets>
</PropertyGroup>

此配置会阻止RCL的静态资产被合并到主项目的wwwroot，统一本地和发布后的访问路径。

3. 确保Docker发布正确处理静态资产 #

检查Dockerfile的发布阶段，使用标准的dotnet publish命令，确保静态Web资产被正确打包：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 8080

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["JoinRpg.Portal/JoinRpg.Portal.csproj", "JoinRpg.Portal/"]
COPY ["JoinRpg.WebComponents/JoinRpg.WebComponents.csproj", "JoinRpg.WebComponents/"]
RUN dotnet restore "JoinRpg.Portal/JoinRpg.Portal.csproj"
COPY . .
WORKDIR "/src/JoinRpg.Portal"
RUN dotnet build "JoinRpg.Portal.csproj" -c Release -o /app/build

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

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

默认情况下dotnet publish会处理静态Web资产，无需额外参数，但若有自定义配置需确认未跳过该步骤。

4. 移除无效的StaticWebAssetsLoader代码 #

StaticWebAssetsLoader.UseStaticWebAssets仅针对本地开发场景的静态资产加载，对发布后的路径问题无帮助，可直接移除该段代码。

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