IIS托管ASP.NET C#程序 网站正常子应用无法访问文件

相同发布包作为独立站点可正常运行、作为子应用时出现文件访问错误，和代码逻辑无关，均为部署配置问题，按以下顺序排查修复即可：

• 确认IIS基础配置合规
  不要只创建虚拟目录挂载子站点，必须右键对应目录选择转换为应用程序；为子应用分配独立应用池，.NET CLR版本、托管管道模式（集成/经典）和独立站点部署时的配置完全一致，禁止复用父站点应用池，避免配置串扰。

• 替换所有硬编码的绝对路径
  独立站点的应用根为域名根路径（/），子应用的根路径为/子应用别名/，所有硬编码的/开头的文件、资源路径都会被解析到父站点根目录，直接触发404：

  • 后端文件读写逻辑禁止手动拼接路径，使用框架提供的路径映射方法：传统.NET Framework 用Server.MapPath("~/文件相对路径")，ASP.NET Core 注入IWebHostEnvironment服务，用WebRootPath/ContentRootPath拼接物理路径；~语法代表应用自身根目录，会自动适配子应用的路径前缀
  • 前端css、js、图片、接口请求不要写/xxx/xxx格式的根绝对路径，Razor视图内用@Url.Content("~/xxx/xxx")生成正确地址，也可以在布局页<head>节点添加<base href="~/"/>，让页面所有相对路径自动基于子应用根解析
  • 排查时可临时加一个测试接口，输出Server.MapPath("~/test.txt")的映射结果，如果返回的物理路径指向父站点目录，即可确认是路径解析逻辑错误。

• 解决web.config继承冲突
  IIS默认会让子应用继承父站点web.config的全部配置，父站点注册的模块、处理程序、URL重写规则、静态文件配置都可能干扰子应用的请求路由：

  • 若有父站点配置修改权限，在父站点web.config中将不需要被子应用继承的节点（如<system.webServer>、<system.web>）包裹在<location path="." inheritInChildApplications="false">标签内，阻断配置向下继承
  • 若无父站点修改权限，在子应用web.config的<modules>、<handlers>、<staticContent>等节点下先添加<clear/>清除所有继承的配置，再重新注册子应用需要的模块、处理程序、MIME类型；如果父站点配置了全局URL重写规则，要在子应用重写规则中开启「终止后续规则」，避免请求被错误重写到父站点路径。

• 校验物理目录权限
  子应用使用独立应用池时，默认运行标识为IIS AppPool\子应用池名称，该账号默认没有对应物理目录的访问权限：
  找到子应用部署的物理文件夹，打开「属性-安全」面板，添加上述应用池标识，授予基础读取权限，有文件上传、写入需求的额外授予修改权限；同时检查父目录是否存在针对该标识的拒绝规则，避免权限继承拦截访问。

• 快速定位技巧
  直接查看IIS日志中失败请求的记录，看日志里的「物理路径」字段：如果路径指向父站点目录，属于路径解析或配置继承问题；如果路径正确但返回401/403状态码，属于权限问题。

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