调用API控制器HttpPost接口时参数值为NULL的问题排查

核心问题 #

1. 请求内容类型未指定：客户端发送的StringContent没有设置Content-Type为application/json，API无法识别这是JSON格式的请求体。
2. 参数绑定不匹配：API接口的string name参数默认会从URL查询字符串、表单数据中绑定，但你把参数放在JSON请求体里，且序列化后的结构和API期望的不匹配；同时API没有声明要从请求体读取该参数。

修复方案（两种可选） #

方案一：修改API接口，从请求体读取单参数

1. API端修改：
   给name参数添加[FromBody]特性，明确告知从请求体读取参数：

[HttpPost("UpdateCountry")]
public async Task<long> UpdateCountry([FromBody] string name)
{
    var countryId = _countryService.GetIdByName(name);

    if (countryId == null)
    {
        var dto = new CountryDto() { Name = name };
        // ... 原有插入逻辑
        countryId = await _countryService.Insert(dto);
    }
    else
    {
        // 补充获取对应dto的逻辑，原代码中dto未定义
        var dto = await _countryService.GetById(countryId.Value);
        dto.Name = name;
        countryId = await _countryService.Update(dto);
    }
    return countryId.Value;
}

2. 客户端修改：
   直接序列化字符串本身，同时给请求设置Content-Type：

public async Task<long> UpdateCountry(string name)
{
    string url = $"{myApi}/Address/UpdateCountry";
    // 直接序列化name字符串，无需包装成KeyValuePair
    var model = JsonConvert.SerializeObject(name);
    long id = await Post(url, model);

    return id;
}

// 基类Post方法补充Content-Type设置
protected async Task<dynamic> Post(string url, string data)
{
    var client = new HttpClient();

    // 设置请求内容类型为application/json
    var httpContent = new StringContent(data, Encoding.UTF8, "application/json");
    HttpResponseMessage responseMessage = await client.PostAsync(url, httpContent);

    var result = await responseMessage.Content.ReadAsStringAsync();

    return JsonConvert.DeserializeObject<dynamic>(result);
}

方案二：使用DTO对象传递参数（更规范、易扩展）

定义统一的请求DTO类，客户端和API端用它传递参数：

1. 定义共享DTO类（可放在客户端和API端都能引用的类库中）：

public class CountryUpdateRequest
{
    public string Name { get; set; }
}

2. API端修改：
   接收DTO对象作为参数：

[HttpPost("UpdateCountry")]
public async Task<long> UpdateCountry([FromBody] CountryUpdateRequest request)
{
    var name = request.Name;
    var countryId = _countryService.GetIdByName(name);

    if (countryId == null)
    {
        var dto = new CountryDto() { Name = name };
        // ... 原有插入逻辑
        countryId = await _countryService.Insert(dto);
    }
    else
    {
        var dto = await _countryService.GetById(countryId.Value);
        dto.Name = name;
        countryId = await _countryService.Update(dto);
    }
    return countryId.Value;
}

3. 客户端修改：
   序列化DTO对象发送请求：

public async Task<long> UpdateCountry(string name)
{
    string url = $"{myApi}/Address/UpdateCountry";
    var model = JsonConvert.SerializeObject(new CountryUpdateRequest { Name = name });
    long id = await Post(url, model);

    return id;
}

// 基类Post方法同样需要设置Content-Type
protected async Task<dynamic> Post(string url, string data)
{
    var client = new HttpClient();

    var httpContent = new StringContent(data, Encoding.UTF8, "application/json");
    HttpResponseMessage responseMessage = await client.PostAsync(url, httpContent);

    var result = await responseMessage.Content.ReadAsStringAsync();

    return JsonConvert.DeserializeObject<dynamic>(result);
}

额外注意点 #

• 原API代码的else块中dto未定义，需要补充获取对应CountryDto的逻辑，否则会编译报错。
• 建议复用HttpClient实例，而非每次请求都新建，避免socket资源耗尽问题。

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