调试Asp.Net Core应用时IIS Express中Scripts文件夹缺失致404错误

问题现象 #

• 新开发机器使用Visual Studio 2022运行Asp.Net Core应用，编译正常、首页可正常加载，但浏览器访问/scripts文件夹下文件时触发404错误，Sources面板中无scripts文件夹
• 该解决方案在旧机器、同事机器及部署到独立IIS服务器时均正常，仅本地通过IIS Express运行时出现异常
• 已对比Web.config和applicationhost.config文件，与正常机器内容完全一致

排查解决步骤 #

1. 检查项目scripts文件夹的属性 #

• 右键项目中的scripts文件夹→属性，确保复制到输出目录设置为如果较新则复制或始终复制
• 逐一检查文件夹内文件的属性，确认复制到输出目录未被错误设置为不复制

2. 清理并重建解决方案 #

• 执行菜单命令：生成→清理解决方案
• 删除项目根目录下的bin和obj文件夹
• 重新执行生成→生成解决方案，再启动调试

3. 重置IIS Express配置 #

• 关闭Visual Studio及所有IIS Express进程
• 删除以下路径的IIS Express配置文件夹：

  %userprofile%\Documents\IISExpress
  

• 重新打开Visual Studio加载解决方案，再次启动调试（VS会自动重建新的IIS Express配置）

4. 检查VS调试启动设置 #

• 右键项目→属性→调试
• 确认应用URL与正常机器一致，未因路径映射修改导致异常
• 尝试勾选启用匿名身份验证（部分权限配置可能导致静态资源无法访问）

5. 验证静态资源中间件配置 #

• 确认Program.cs（或Startup.cs）中已正确配置静态资源中间件：

  app.UseStaticFiles(); // 确保此代码在路由配置前调用
  

• 若scripts为自定义静态资源目录，需补充配置：

  app.UseStaticFiles(new StaticFileOptions
  {
      FileProvider = new PhysicalFileProvider(
          Path.Combine(Directory.GetCurrentDirectory(), "scripts")),
      RequestPath = "/scripts"
  });
  

6. 禁用VS浏览器链接功能 #

• 打开Tools→Options→Projects and Solutions→Web Projects
• 取消勾选启用浏览器链接，重启调试后测试

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