在独立MVC项目中调用Web API的Put方法报错，求排查方案

我搭建了连接人员数据库的Web API，从独立MVC项目调用它实现CRUD操作。目前Get（查看列表）、Post（创建人员）方法都能正常工作，但调用Put方法更新人员时出现错误。直接通过API操作数据库是正常的，尝试调整过MVC项目中的请求URL，但问题仍未解决。

API端UpdatePerson方法代码 #

[HttpPut]
[Route("{id:guid}")]
public async Task<IActionResult> UpdatePerson([FromRoute] Guid id, UpdatePersonRequest updatePersonRequest)
{
    var person = await dbContext.Persons.FindAsync(id);

    if (person != null)
    {   
        person.Name = updatePersonRequest.Name;
        person.Email = updatePersonRequest.Email;
        person.Phone = updatePersonRequest.Phone;
        person.Address = updatePersonRequest.Address;

        await dbContext.SaveChangesAsync();

        return Ok(person);
    }
}

MVC项目调用API的代码 #

[HttpGet]
public IActionResult Edit()
{
    return View();
}

[HttpPost]
public async Task<IActionResult> Edit(PersonViewModel pvm)
{
    HttpClient client = new();
    StringContent sContent = new StringContent(JsonConvert.SerializeObject(pvm), Encoding.UTF8, "application/json");
    HttpResponseMessage response = await client.PutAsync("https://localhost:7281/api/Persons/", sContent);

    response.EnsureSuccessStatusCode();

    if (response.IsSuccessStatusCode)
    {
        return RedirectToAction("Get");
    }
    else
    {
        return NotFound();
    }
}

问题排查与解决方案 #

1. 路由参数缺失（核心问题） #

API的Put方法路由定义为[Route("{id:guid}")]，要求URL必须包含Guid类型的id参数，但MVC调用时的URL是https://localhost:7281/api/Persons/，没有携带id，导致路由匹配失败，直接返回404错误。

修正方法：将PersonViewModel中的Id拼接到请求URL中：

// 确保PersonViewModel包含Id属性（Guid类型）
HttpResponseMessage response = await client.PutAsync($"https://localhost:7281/api/Persons/{pvm.Id}", sContent);

2. API方法缺少空值返回逻辑 #

当前API代码中，如果根据id找不到person，没有返回任何结果，会默认返回204 No Content，这可能导致MVC端的response.EnsureSuccessStatusCode()抛出异常。

修正方法：在API方法末尾添加NotFound返回：

if (person != null)
{   
    // 更新逻辑
    return Ok(person);
}
return NotFound(); // 新增：找不到人员时返回404

3. 模型绑定匹配检查 #

确保PersonViewModel的字段与API端的UpdatePersonRequest字段完全匹配（字段名、数据类型一致），避免Json序列化后模型绑定失败，导致更新参数为空。

4. HttpClient优化（非紧急但建议） #

每次调用都new HttpClient可能导致socket资源耗尽，建议在MVC项目中通过IHttpClientFactory注入HttpClient：

// 在Startup/Program.cs中注册
builder.Services.AddHttpClient();

// 在Controller中注入
private readonly IHttpClientFactory _httpClientFactory;
public YourController(IHttpClientFactory httpClientFactory)
{
    _httpClientFactory = httpClientFactory;
}

// 使用时
var client = _httpClientFactory.CreateClient();

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