UseStaticFiles默认仅服务wwwroot目录，需通过StaticFileOptions显式配置FileProvider和RequestPath才能支持自定义路径；必须确保物理目录存在且有读取权限，中间件顺序应置于UseRouting之后、UseEndpoints之前。
UseStaticFiles 默认只服务 wwwroot 目录
ASP.NET Core 的 UseStaticFiles 中间件默认只从项目根目录下的 wwwroot 文件夹提供静态文件。如果你把图片放在 images/、uploads/ 或其他自定义路径，直接访问会返回 404 —— 不是因为路径写错，而是中间件根本没被配置去扫描那里。
常见错误现象：http://localhost:5000/images/logo.png 返回 404，但把同一张图挪到 wwwroot/images/logo.png 就能正常加载。
- 必须确保目标目录是物理存在的，且应用有读取权限（尤其在 Linux 或 IIS 部署时）
-
wwwroot是约定目录，不是硬编码路径；你不能靠改项目结构绕过中间件配置 - 开发时用 Visual Studio 启动，
wwwroot需在项目文件中设为“内容”并“始终复制”，否则发布后缺失
配置非 wwwroot 目录需显式指定 FileProvider 和 RequestPath
要让 UseStaticFiles 服务 D:\assets\photos 或项目内 MyImages/，必须传入 StaticFileOptions，明确告诉它「从哪读」和「对外挂哪条 URL 路径」。
例如，你想通过 /photos/xxx.jpg 访问 MyImages/ 子目录里的文件：
app.UseStaticFiles(new StaticFileOptions
{
FileProvider = new PhysicalFileProvider(
Path.Combine(env.ContentRootPath, "MyImages")),
RequestPath = "/photos"
});
-
FileProvider指向真实磁盘路径，用PhysicalFileProvider最常用；别漏掉env.ContentRootPath拼接，硬写绝对路径会导致跨环境失效 -
RequestPath是浏览器请求的 URL 前缀（必须以/开头），它不对应磁盘结构，只是路由映射 - 多个
UseStaticFiles调用可共存，但顺序重要：更具体的应放在前面，避免被通配规则覆盖
启用目录浏览需额外调用 UseDirectoryBrowser
UseStaticFiles 默认禁止列出目录内容，即使你访问 /photos/ 这样的路径，也会 403 或 404。要支持类似旧式 FTP 那样的文件列表页，得单独加 UseDirectoryBrowser。
注意：它必须与 UseStaticFiles 共享同一 FileProvider 和 RequestPath，否则路径对不上：
var photosPath = Path.Combine(env.ContentRootPath, "MyImages");
app.UseStaticFiles(new StaticFileOptions
{
FileProvider = new PhysicalFileProvider(photosPath),
RequestPath = "/photos"
});
app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
FileProvider = new PhysicalFileProvider(photosPath),
RequestPath = "/photos"
});
- 开发环境才建议开启
UseDirectoryBrowser，生产环境务必禁用，避免敏感文件暴露 - 它不提供下载或预览功能，只渲染 HTML 列表；点击文件仍走
UseStaticFiles流程 - 若同时注册了多个
UseDirectoryBrowser，只有第一个生效；重复注册不会报错但无意义
图片无法加载的三个隐蔽原因
即使路径和配置都对，图片仍可能不显示，问题常出在 MIME 类型、缓存头或扩展名映射上。
- 某些图片格式（如
.webp、.avif）未被 ASP.NET Core 默认识别，浏览器收到text/plainContent-Type 就拒绝渲染；需手动添加映射：options.MimeTypes.Add("image/webp", "image/webp"); - 本地开发时浏览器强缓存了 404 响应，换路径后仍显示旧错误；可加
options.OnPrepareResponse = ctx => ctx.Context.Response.Headers["Cache-Control"] = "no-cache";临时绕过 - Windows 上文件扩展名大小写不敏感，但 Linux 部署后
Logo.PNG和logo.png是两个文件；URL 中的大小写必须与磁盘文件完全一致
最易被忽略的是：UseStaticFiles 必须放在 UseRouting 之后、UseEndpoints 之前，顺序错会导致中间件根本不执行。
