为何调用HTTP POST接口时出现Fetch错误（Internal Server Error）？

问题呈现 #

调用接口时返回Fetch error - Internal Server Error，涉及的两个POST接口代码如下：

[HttpPost]
[ActionName("CreatePostWithMediaId")]
public async Task<IActionResult> CreatePost([FromForm]string? heading, 
    [FromForm]string content, 
    [FromForm] int tagId, 
    [FromForm] int? mediaId = null)
{
    content = content.Replace(@"\n", "\n");
    Post post = new Post()
    {
        heading = heading,
        content = content,
        tag = tagId,
        mediaId = mediaId,
        date = DateTime.UtcNow,
    };
    _unitOfWork.PostRepository.Create(post);
    _unitOfWork.Save();
    return Ok(post);
}

[HttpPost]
[ActionName("CreatePostWithFile")]
public async Task<IActionResult> CreatePost([FromForm] string? heading,
    [FromForm] string content,
    [FromForm] int tagId,
    [FromForm] IFormFile? file = null)
{
    content = content.Replace(@"\n", "\n");
    var mediaResult = await _fileManager.UploadFile(file);
    Post post = new Post()
    {
        heading = heading,
        content = content,
        tag = tagId,
        mediaId = mediaResult.id,
        date = DateTime.UtcNow,
    };
    _unitOfWork.PostRepository.Create(post);
    _unitOfWork.Save();
    return Ok(post);
}

核心问题与修复方案 #

1. 路由匹配冲突 #

两个接口均使用[HttpPost]且方法名相同，仅靠[ActionName]无法让ASP.NET Core路由系统可靠区分请求，导致请求匹配混乱触发500错误。

修复：
给每个接口添加唯一的路由模板，直接区分请求路径：

// 第一个接口：使用明确路由
[HttpPost("create-post/with-media-id")]
public async Task<IActionResult> CreatePostWithMediaId([FromForm]string? heading, 
    [FromForm]string content, 
    [FromForm] int tagId, 
    [FromForm] int? mediaId = null)
{
    // 原有业务代码
}

// 第二个接口：使用不同路由
[HttpPost("create-post/with-file")]
public async Task<IActionResult> CreatePostWithFile([FromForm] string? heading,
    [FromForm] string content,
    [FromForm] int tagId,
    [FromForm] IFormFile? file = null)
{
    // 原有业务代码
}

2. 空引用与未捕获异常 #

• 第二个接口中，若file为null，_fileManager.UploadFile(file)可能返回null，后续访问mediaResult.id会直接抛出空引用异常。
• 数据库操作（Create、Save）可能因约束违反（如tagId不存在、必填字段为空）抛出未捕获异常。

修复：
添加空值校验与异常捕获：

// 第二个接口中增加文件上传结果校验
var mediaResult = await _fileManager.UploadFile(file);
if (mediaResult == null)
{
    return BadRequest("文件上传失败");
}

// 给数据库操作添加异常捕获
try
{
    _unitOfWork.PostRepository.Create(post);
    _unitOfWork.Save();
}
catch (DbUpdateException ex)
{
    // 可添加日志记录
    return StatusCode(StatusCodes.Status500InternalServerError, "数据保存失败：" + ex.InnerException?.Message ?? ex.Message);
}

3. 定位具体错误 #

开启详细日志或本地调试，直接获取异常堆栈：

• 在appsettings.json中配置日志级别：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Debug",
      "Microsoft.EntityFrameworkCore": "Debug"
    }
  }
}

• 本地调试时给接口方法加断点，逐步执行排查异常触发点。

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