.NET 5下dotnet pack打包staticwebassets时无扩展名文件生成额外文件夹致发布失败

我之前帮开发者排查过类似问题，这确实是.NET 5 SDK里dotnet pack处理无扩展名静态Web资产的一个已知行为——SDK会误把无扩展名的文件当成目录来处理，导致打包后出现嵌套结构，进而和.props文件里的正确路径冲突，触发MSB3025错误。除了删除或重命名文件，这里有几个可行的解决方案：

1. 自定义MSBuild目标修正打包逻辑 #

你可以在类库项目的.csproj文件里加一段自定义的MSBuild目标，在打包流程启动前，强制指定无扩展名文件的路径规则，避免生成多余目录：

<Target Name="FixNoExtensionStaticWebAssets" BeforeTargets="_PrepareStaticWebAssetsForPublish">
  <ItemGroup>
    <StaticWebAsset Include="@(StaticWebAsset)" Condition=" '%(Extension)' == '' ">
      <RelativePath>%(RelativePath)</RelativePath>
      <TargetPath>%(RelativePath)</TargetPath>
    </StaticWebAsset>
  </ItemGroup>
</Target>

这个目标会在SDK准备静态Web资产的阶段介入，让无扩展名文件的相对路径和目标路径保持完全一致，从根源上阻止错误的目录嵌套生成。

2. 配置StaticWebAssetBasePath+路径转换 #

另一种思路是通过设置StaticWebAssetBasePath属性，再配合自定义的路径转换规则，明确告诉SDK无扩展名文件的正确打包路径：

在项目文件中添加以下配置：

<PropertyGroup>
  <!-- 指定静态资产的基础路径，根据你的项目结构调整 -->
  <StaticWebAssetBasePath>wwwroot</StaticWebAssetBasePath>
</PropertyGroup>

<Target Name="AdjustNoExtensionAssetPaths" BeforeTargets="ResolveStaticWebAssets">
  <ItemGroup>
    <StaticWebAsset Include="@(StaticWebAsset)" Condition=" '%(Extension)' == '' ">
      <TargetPath>$(StaticWebAssetBasePath)/%(RecursiveDir)%(Filename)</TargetPath>
    </StaticWebAsset>
  </ItemGroup>
</Target>

这种方式直接覆盖了SDK默认的路径生成逻辑，确保无扩展名文件被打包到正确的位置，不会产生额外目录。

3. 升级到.NET 6及以上SDK（如果项目允许） #

其实这个问题在.NET 6及更高版本的SDK里已经被微软修复了——他们优化了静态Web资产的打包识别逻辑，能正确区分无扩展名文件和目录。如果你的项目可以升级到.NET 6或更高版本，这绝对是最省心的方案，不需要改任何项目配置，直接升级SDK就能解决问题。

验证方法 #

不管用哪种方案，改完配置后先执行dotnet pack生成NuGet包，然后解压包看看staticwebassets目录下的结构，确认无扩展名文件没有被嵌套到多余目录里，同时检查.props文件里的路径是否依然正确。之后在引用该包的项目里跑dotnet publish，验证MSB3025错误是否消失。

内容的提问来源于stack exchange，提问作者g.pickardou