ASP.NET Core 6 MVC中wwwroot静态文件无法加载的问题排查

• 核对访问路径与文件实际位置：wwwroot是静态文件的根目录，若你的CSS文件在wwwroot/Content/css-new/site.css，正确的访问URL应为http://localhost:58233/Content/css-new/site.css。确认你是否遗漏了具体文件名，或文件实际存放层级与URL不符（比如误将文件放在了项目根目录而非wwwroot下）。

• 检查文件的复制属性：右键目标CSS文件 → 打开「属性」面板，确认「复制到输出目录」选项设置为如果较新则复制或始终复制。即使构建目录能看到文件，也可能存在文件未同步更新的情况。

• 确认中间件顺序：在Program.cs中，app.UseStaticFiles();必须放在路由相关中间件之前，正确的顺序示例如下：

  app.UseHttpsRedirection();
  app.UseStaticFiles(); // 静态文件中间件要放在路由之前
  app.UseRouting();
  app.UseAuthorization();
  app.UseEndpoints(endpoints =>
  {
      endpoints.MapControllerRoute(
          name: "default",
          pattern: "{controller=Home}/{action=Index}/{id?}");
  });
  

  若静态文件中间件被放在路由或授权中间件之后，可能导致请求被提前拦截。

• 排查自定义WebRoot配置：检查Program.cs中是否有指定自定义WebRoot的代码，比如：

  var builder = WebApplication.CreateBuilder(args);
  builder.WebHost.UseWebRoot("CustomStaticFiles"); // 若设置了这个，静态文件根目录就不是wwwroot了
  

  如果存在此类配置，需将静态文件移至指定目录，或移除该配置恢复默认的wwwroot根目录。

• 检查URL大小写敏感性：Windows系统默认不区分路径大小写，但如果后续会部署到Linux环境，或当前使用了大小写敏感的服务器配置，需确保URL中的路径与文件实际路径完全一致（比如文件是Content/CSS-New，URL不能写成Content/css-new）。

• 排查自定义中间件拦截：检查是否存在自定义中间件在app.UseStaticFiles();之前就处理了请求，导致静态文件请求被拦截返回404。可以临时注释非必要的自定义中间件，测试静态文件是否能正常访问。

• 验证项目运行端口：核对launchSettings.json中的applicationUrl配置，确认你访问的58233端口是项目实际运行的端口，避免因端口不匹配导致404。

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