Linux虚拟机中使用app.MapStaticAssets()无法加载静态文件

以下是几个关键点，帮你定位问题：

• 路由处理逻辑差异导致请求被拦截
  MapStaticAssets()是基于端点路由的静态资源处理中间件，而UseStaticFiles()是传统的管道式中间件。你当前的Nginx配置直接拦截了所有静态后缀的请求，从本地wwwroot目录返回文件，完全没把请求转发给ASP.NET Core应用——这就导致MapStaticAssets()根本没机会处理这些请求，自然加载失败。

• 调整Nginx配置，让请求到达ASP.NET Core
  你需要修改Nginx的静态资源处理规则：

  • 方案一：直接移除那个匹配静态后缀的location块，让所有请求都转发到ASP.NET Core后端，由MapStaticAssets()负责静态资源交付；
  • 方案二：如果想保留Nginx处理部分静态资源，可调整规则，把需要ASP.NET Core处理的静态请求转发到后端，示例：

    # 保留Nginx处理部分静态资源
    location ~* ^.+\.(css|js|jpg)$ {
        root /path/to/my/app/wwwroot;
        expires max;
        access_log off;
    }
    # 其他静态资源转发到ASP.NET Core
    location ~* ^.+\.(svg|woff2|eot)$ {
        proxy_pass http://localhost:5000; # 你的ASP.NET Core应用地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    

• 验证MapStaticAssets()的配置细节
  默认MapStaticAssets()映射根路径/，如果你配置了自定义前缀（比如app.MapStaticAssets("/static", options => { ... })），要确保前端请求的路径和配置一致，同时Nginx要正确转发对应路径的请求到后端。

• 检查静态资源的发布与权限
  确认服务器上的wwwroot目录已正确发布所有静态文件，且ASP.NET Core应用进程有读取该目录的权限。另外，可检查项目的StaticWebAssets相关配置（比如appsettings.json里的项），确保没有路径配置错误。

• 查看日志定位问题
  查看ASP.NET Core应用的日志，确认静态资源请求是否到达应用；同时检查Nginx的access.log和error.log，看请求是被Nginx拦截处理，还是转发到了后端，有没有报错信息。

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