.Net Core Web API发布至IIS后接口返回204 No Content（开发环境正常）

问题复现场景 #

开发阶段通过Visual Studio启动调试时，所有接口均可正常返回预期数据，发布到IIS（站点下部署应用名为DailyMart）后，访问相同格式路由却返回204状态码，业务逻辑完全没有触发。

示例接口代码：

[HttpGet]
[Route("GetProducts/{Id}")]
public ActionResult<IEnumerable<Mart_Model.ProductStock>> GetProducts(int id)
{
    try
    {
        var Products = _repository.GetProducts(id);
        return Ok(Products);
    }
    catch(Exception ex) {
        return BadRequest(new Response { Status = "Error", Message = ex.ToString() }); 
    }
}

• 本地调试正常访问地址：http://localhost:49774/api/martController/GetProducts/0，可正常返回产品列表
• IIS部署后异常访问地址：http://localhost/DailyMart/api/martController/GetProducts/0，返回204 No Content

核心排查方向 #

路由匹配规则不匹配（最常见原因） #

你当前的Action标注了硬编码路由[Route("GetProducts/{Id}")]，需要确认控制器层面的路由配置：

• 如果控制器上没有配置统一的[Route("api/[controller]")]前缀，这个Action实际能匹配的完整路由是GetProducts/{id}，在IIS的DailyMart虚拟应用下，真实可访问的路径应为http://localhost/DailyMart/GetProducts/0
• 你当前访问的带api/martController前缀的地址，根本无法匹配到任何已注册的端点，路由中间件在匹配不到对应Action时，会直接返回204，不会触发你写的try-catch业务逻辑
• 修正方式：检查控制器类上的路由标注，确保路由拼接结果和你实际访问的地址完全匹配，避免出现路由前缀缺失、重复拼接的冲突问题

环境差异导致的资源访问失败 #

本地调试时运行在Development环境，IIS部署后默认运行在Production环境，两边运行时的权限、配置存在差异：

• 你代码里依赖的_repository如果需要访问数据库、本地文件等资源，IIS对应的应用池身份默认权限较低，可能没有足够的访问权限，导致Repository方法抛出异常，且异常被全局中间件在进入Action前拦截，框架会对没有有效返回内容的请求直接返回204，根本走不到你写的catch块
• 排查操作：
  • 查看IIS的请求日志和Windows事件查看器，确认请求是否真的进入了应用逻辑
  • 临时将部署应用的环境变量改为Development，和本地调试环境完全对齐，再验证接口返回
  • 检查对应应用池的身份标识，为其分配必要的数据库、文件访问权限

ANCM模块配置异常 #

如果部署时没有正确安装对应版本的.NET Core Hosting Bundle，或者发布目录下的web.config配置有误，会导致IIS的.NET Core模块无法把请求正确转发给Kestrel进程：

• 这种情况下请求根本没有进入应用的业务管道，IIS层的静态文件/路由处理逻辑会直接返回204
• 排查操作：
  • 检查发布目录下web.config中aspNetCore节点的配置，确认指向的程序集文件路径和实际发布的dll文件名完全一致
  • 确认服务器安装的Hosting Bundle版本和你发布应用的目标框架版本完全匹配

序列化静默失败 #

如果返回的Mart_Model.ProductStock模型存在循环引用结构，生产环境下的序列化器遇到无法解析的对象时，可能不会抛出显式异常，而是静默返回空内容，最终呈现为204状态码

• 排查操作：临时打开应用的详细错误提示，检查序列化流程是否存在静默失败的情况

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