ASP.NET Core 8 Web API部署为IIS子目录应用时404错误求助

• 项目基础情况：ASP.NET Core 8 Web API项目，采用发布文件夹方式部署至IIS服务器，本地运行及作为独立站点（绑定独立端口）运行均正常。
• 触发问题的操作步骤：
  1. 将发布文件夹部署为主站点的子目录
  2. 将该子目录转换为IIS应用程序
  3. 配置至独立的「无托管代码」应用池
  4. 启用匿名认证
• 当前问题：无论调整代码路由、修改应用池配置、回收应用池或重启站点，访问时均返回404错误。AspNetCoreV2处理程序配置正常，Web.config完全保留发布生成时的状态。

排查及解决方法 #

1. 配置路由基路径
   部署到子目录的ASP.NET Core应用需要明确路由基路径，否则无法正确匹配请求。在Program.cs中添加：

   app.UsePathBase("/你的子目录名称");
   

   也可在发布时通过参数指定：dotnet publish /p:BasePath=/你的子目录名称，确保路由能识别子目录层级。

2. 验证IIS处理程序映射
   进入子目录应用的「处理程序映射」设置，确认AspNetCoreModuleV2已正确关联*.路径，确保所有请求都能被ASP.NET Core处理，而非IIS默认静态文件处理程序。

3. 检查应用池权限与配置

   • 确认应用池的.NET CLR版本设置为「无托管代码」
   • 检查应用池身份标识是否拥有子目录文件的读取、执行权限，可临时改为LocalSystem（仅测试用，生产环境需用最小权限账户）验证是否为权限问题。

4. 启用ASP.NET Core日志排查
   修改Web.config中的aspNetCore节点，启用标准输出日志：

   <aspNetCore processPath="dotnet" arguments=".\你的项目.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
   

   确保logs目录存在且有写入权限，查看日志可定位404的具体原因（如应用未启动、路由匹配失败等）。

5. 确认子目录的应用属性
   在IIS管理器中右键子目录，确认已成功「转换为应用程序」，而非仅作为虚拟目录，且应用程序池选择正确。

6. 核对API路由配置
   确保控制器的路由前缀与访问路径匹配，例如控制器路由为[Route("api/[controller]")]时，访问路径应为http://主域名/子目录/api/控制器名称，避免路由前缀与子目录层级冲突。

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