Blazor WASM仅重建整个解决方案后才可正常运行问题求助

针对你遇到的局部修改子项目后必须全量重建、静态资源404、程序集加载失败等问题，可尝试以下解决方案：

• 清理构建缓存与输出目录
  手动删除所有相关项目的bin和obj目录，执行dotnet clean命令清除残留构建文件，同时清空浏览器缓存（尤其是Blazor的离线缓存），再重新构建修改的子项目及依赖它的WASM/Server项目。

• 检查项目引用与构建顺序
  确认WASM项目对子项目的引用是项目引用而非本地DLL引用；在解决方案属性中设置正确的构建顺序，确保子项目优先于WASM和Server项目构建，避免依赖项未及时更新。

• 修复静态资源路由配置
  在Server项目的Program.cs中确认静态文件中间件配置正确：

  app.UseStaticFiles();
  app.UseBlazorFrameworkFiles();
  

  检查Butterfly.styles.css等静态文件是否存在于WASM项目的wwwroot目录，且在项目属性中设置了“复制到输出目录”为“始终复制”或“较新时复制”。

• 彻底处理AOT编译残留
  即使禁用了AOT，残留的编译文件可能导致冲突：删除Server项目发布目录下的wwwroot/_framework文件夹，同时确保Server项目文件中彻底移除<RunAOTCompilation>true</RunAOTCompilation>配置项。

• 解决程序集加载与类型异常

  • 统一所有项目的程序集版本号，避免版本不匹配导致的Could not load file or assembly错误；
  • 严格检查虚方法签名：子类重写的方法需与父类的返回值、参数类型、泛型参数、可空修饰符完全一致，排除签名不匹配引发的TypeLoadException；
  • 在WASM项目的PropertyGroup中添加<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>，确保所有依赖程序集被正确复制到输出目录。

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