二次执行dotnet build失败：静态Web资产路径冲突求助

核心问题分析 #

自定义Identity UI后，项目同时加载了NuGet包自带的Identity静态资产和自定义的Identity静态文件，加上开发机（C:\source）与staging服务器（C:\share\source）的目录结构差异，构建工具在处理静态资产指纹时，识别到两个不同来源的资产指向同一目标路径css/site#[.{fingerprint}]?.css，从而抛出冲突错误。临时重命名Identity目录仅能清空首次构建的缓存，二次构建时旧缓存残留会再次触发冲突。

解决方案 #

1. 强制清理构建缓存 #

每次构建前先执行清理命令，彻底清除之前生成的缓存文件：

dotnet clean
dotnet build

2. 排除NuGet包中的Identity UI静态资产 #

在项目的.csproj文件中添加配置，直接排除Identity UI包自带的静态资源，只保留自定义的文件：

<ItemGroup>
  <!-- 排除Identity UI包的静态资产，仅保留必要代码逻辑 -->
  <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="9.0.1">
    <ExcludeAssets>contentfiles;build</ExcludeAssets>
  </PackageReference>
  <!-- 确保自定义的Identity静态文件被正确识别 -->
  <Content Include="Areas\Identity\**\*.css" />
  <Content Include="Areas\Identity\**\*.js" />
</ItemGroup>

3. 统一迁移执行路径 #

无需复制开发机的C:\source目录到staging服务器，直接在项目发布目录下执行数据库迁移：

# 进入发布目录
cd C:\share\source\YourPublishedProject
# 指定项目文件执行迁移
dotnet ef database update --project C:\share\source\YourProject.csproj

4. 检查自定义视图的静态资源引用 #

确保自定义的Identity视图（如登录页、注册页）中引用的CSS/JS是相对路径，避免使用开发机的绝对路径，例如：

<!-- 正确写法 -->
<link rel="stylesheet" href="~/css/site.css" />
<!-- 错误写法（需避免） -->
<link rel="stylesheet" href="C:\source\wwwroot\css\site.css" />

临时方法生效原因说明 #

重命名Areas/Identity目录后，首次构建会重新扫描并生成自定义资产的缓存，但二次构建时，构建工具会读取之前残留的NuGet包资产缓存，导致路径冲突再次触发，因此无法彻底解决问题。

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