.NET Core 3.1返回文件的REST API部署IIS报404错误如何处理

你遇到的现象本质不是IIS缺少返回文件的特殊配置，你另外两个接口运行正常，说明ASP.NET Core的基础IIS部署配置已经正确。
报错Cannot return null from an action method with a return type of 'Microsoft.AspNetCore.Mvc.FileResult'以及404响应，是因为你的代码执行触发了异常进入catch块，直接返回了null，ASP.NET Core会将返回null的FileResult默认处理为404响应。本地运行正常是因为开发环境的文件路径、权限、系统配置都满足代码运行要求，部署到IIS后环境变化触发了异常。

• 优先修正catch块的返回逻辑，不要直接返回null，建议增加日志记录同时返回明确的错误响应，方便快速定位具体异常原因：

catch (Exception ex)
{
    // 此处可注入ILogger记录完整异常栈，排查问题更高效
    return StatusCode(StatusCodes.Status500InternalServerError, ex.Message);
}

• 排查模板文件路径问题：你代码中使用了相对路径"ABC.docx"，IIS运行时的工作目录为站点根目录，需确认：
  • ABC.docx文件已随发布文件一同部署到站点对应目录
  • 项目中该文件的「复制到输出目录」属性已设置为「如果较新则复制」，避免发布时遗漏文件
• 排查目录权限问题：给站点对应的应用程序池身份，授予站点根目录的读取权限，避免因权限不足无法读取模板文件触发IO异常
• 排查日期转换异常：服务器的区域文化配置可能和本地开发环境不同，无指定格式的Convert.ToDateTime会使用服务器系统默认的日期格式解析传入的字符串，格式不匹配就会抛异常，建议改为指定格式的日期解析逻辑：

// 请根据你实际传入的日期格式调整第二个参数的格式字符串
DateTime FromDate = DateTime.ParseExact(FDate, "yyyy-MM-dd", CultureInfo.InvariantCulture);
DateTime ToDate = DateTime.ParseExact(TDate, "yyyy-MM-dd", CultureInfo.InvariantCulture);

如果下载文件时出现MIME类型不识别的问题，可在IIS站点的MIME类型配置中，新增扩展名.docx对应的MIME值为application/vnd.openxmlformats-officedocument.wordprocessingml.document，你代码中返回FileResult时已经明确指定了ContentType，一般无需额外配置该规则。

内容的提问来源于stack exchange，提问作者Ajay Pal Singh