ASP.NET Core 5.0应用部署到IIS 10后照片相关功能异常如何解决

基础环境配置排查 #

• 确认IIS的静态内容功能已安装：打开服务器管理器>添加角色和功能>Web服务器（IIS）>Web服务器>常见HTTP功能，确认勾选「静态内容」，同时检查应用代码的Startup.cs/Program.cs中已注册app.UseStaticFiles()中间件
• 确认照片存储目录权限：应用对应的IIS应用程序池身份（默认格式为IIS AppPool\你的应用池名称），需要对照片存储的文件夹拥有读取、写入、修改权限，右键目标文件夹>属性>安全>编辑>添加对应身份后勾选权限保存
• 确认部署路径无特殊字符：如果应用部署路径包含中文、空格或特殊符号，会导致相对路径解析异常，建议将应用部署到全英文无特殊符号的路径下
• 确认IIS请求筛选未拦截图片后缀：打开IIS站点的「请求筛选」>文件扩展名，确认你使用的图片格式（.jpg/.png/.webp等）处于允许状态

查询照片列表404问题专项排查 #

• 确认路由前缀是否匹配：如果站点部署在IIS虚拟目录/应用程序下，接口路由需要加上虚拟目录前缀，比如本地路由为/api/photo/list，部署在虚拟目录/myapp下的话，完整路由应为/myapp/api/photo/list
• 处理静态文件模块拦截问题：如果接口路径包含/photo、/images这类静态资源关键字，IIS静态文件模块会优先匹配静态文件，找不到就返回404，需要在web.config中添加配置调整处理优先级：

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    <remove name="StaticFileModule" />
    <add name="StaticFileModule" type="Microsoft.AspNetCore.StaticFiles.StaticFileMiddleware" />
  </modules>
</system.webServer>

• 确认路径配置一致性：检查本地配置的照片访问根路径，是否和服务器上的实际存储路径一致，避免路径拼接错误导致返回的图片访问地址无效

新增照片接口500错误专项排查 #

• 开启详细日志定位异常：临时在appsettings.json中将日志级别调整为Debug，也可以查看Windows事件查看器>Windows日志>应用程序，找到对应ASP.NET Core的报错记录，定位具体异常原因
• 调整请求大小限制：IIS默认最大请求大小为30MB，ASP.NET Core默认最大请求体为30MB，超过限制会触发500错误，需要在web.config中添加配置：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 单位为字节，此处配置为100MB，可根据需求调整 -->
      <requestLimits maxAllowedContentLength="104857600" />
    </requestFiltering>
  </security>
</system.webServer>

同时在Program.cs中配置Kestrel的请求大小限制：

builder.Services.Configure<Microsoft.AspNetCore.Server.Kestrel.Core.KestrelServerOptions>(options => 
{
    options.Limits.MaxRequestBodySize = 100 * 1024 * 1024;
});

• 确认存储路径有效性：检查代码中配置的照片存储路径，是本地特有的路径（比如C:\local_photos），服务器上不存在该目录会导致写入失败，建议在配置文件中显式配置服务器端的绝对存储路径

验证修复 #

所有配置修改完成后，重启对应IIS应用程序池和站点，重新测试两个接口功能即可。

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