ImageSharp.Web配置AzureBlobStorageImageProvider后图片请求返回404问题排查

可能遗漏的配置项/常见错误点： #

• 中间件注册顺序错误：app.UseImageSharp() 必须放在 app.UseStaticFiles()、路由、授权等中间件之前注册，否则图片请求会被前置中间件拦截直接返回404。
• 缺少对应Nuget包安装：需要确认已经安装了SixLabors.ImageSharp.Web.Providers.Azure正式版包，版本要和你引用的ImageSharp.Web核心包版本一致，版本不兼容也会导致provider加载失败返回404。
• 源容器权限不足：你配置的源容器 test-container 要么公共访问权限设置为私有且使用的连接字符串没有Blob数据读取权限，要么容器不存在。需要确认连接字符串对应的Azure账号有test-container的读取权限，或者容器公共访问级别调整为Blob/容器级别。
• 请求URL与配置不匹配：你配置的源容器名为test-container，请求URL第一段必须和配置的容器名完全一致，正确的请求格式应为https://localhost:44336/test-container/文件名.jpg?width=30，如果URL里的容器名写错就会返回404。
• 缺少图片格式注册：如果你的图片格式是WebP、Gif等非默认注册的格式，需要在AddImageSharp()链式调用中补充对应格式的注册，比如.AddWebp()、.AddGif()，否则ImageSharp无法识别资源会返回404。
• Blob路径不匹配：如果你的图片存放在test-container的子目录下，请求URL必须带上完整的子路径，比如图片存放在test-container/avatar/user1.jpg，请求路径就应该是/test-container/avatar/user1.jpg。

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