ASP.NET Core与React项目发布时缺少wwwroot目录的解决方案

问题背景

在使用ASP.NET Core与React项目模板时，开发者发现发布项目后生成的输出目录中缺少了关键的wwwroot文件夹。这个文件夹原本应该包含Vite构建生成的dist文件夹内容，用于托管前端应用。缺少这个文件夹会导致应用运行时无法正确加载前端资源。

问题根源分析

经过深入调查，发现问题的根源在于Microsoft.VisualStudio.JavaScript.SDK版本的变化：

1. 旧版本SDK(如0.5.271090-alpha)使用Sdk.WebAssets.targets文件
2. 新版本SDK(如1.0.2191419)使用Sdk.targets文件

这两个版本在构建过程中产生了完全不同的输出结果。特别是新版本中，关键的_PublishCopyStaticWebAssetsPreserveNewest目标被跳过，导致前端资源没有被复制到发布目录中。

解决方案

目前有以下几种解决方案：

1. 降级SDK版本：将项目文件中的SDK引用改为已知可用的旧版本

<Project Sdk="Microsoft.VisualStudio.JavaScript.Sdk/1.0.1738743">

2. 等待官方修复：微软已经确认在1.0.2655793及更高版本中修复了此问题

技术细节

在构建过程中，正常情况下应该执行以下步骤：

1. Vite构建前端应用，生成dist目录
2. 构建系统将dist目录内容复制到wwwroot目录
3. 发布过程将wwwroot目录包含在最终输出中

但在有问题的版本中，第二步被跳过，导致最终发布包中缺少前端资源。

最佳实践建议

1. 对于新项目，建议直接使用最新版本的SDK(1.0.2655793或更高)
2. 对于现有项目，可以暂时降级SDK版本，待升级Visual Studio后再切换回最新版本
3. 在发布前，始终检查输出目录是否包含完整的wwwroot内容

总结

这个问题展示了前端构建工具链与.NET构建系统集成时可能出现的兼容性问题。通过理解构建过程的关键目标和SDK版本的影响，开发者可以更好地诊断和解决类似问题。微软已经在新版本中修复了此问题，开发者可以根据项目实际情况选择合适的解决方案。