Web API新手求助：Postman中GET请求正常，POST请求故障排查

阿华AIGC实验室

2026-5-21

解决Postman调用Web API POST请求失败的问题

Hey there! Let's break down why your POST request might be failing and get it fixed step by step.

最可能的几个问题及解决方法

1. 缺少`[FromBody]`特性（ASP.NET Web API 经典版）

在传统ASP.NET Web API中，复杂类型的参数不会自动从请求体绑定，你得给Student参数加上[FromBody]特性，明确告诉框架从请求体里读取数据：

[HttpPost]
public HttpResponseMessage StudentDetails([FromBody] Student data) {
    return new HttpResponseMessage() {
        Content = new StringContent(JArray.FromObject(data).ToString(), Encoding.UTF8, "application/json")
    };
}

2. Postman请求配置错误

POST请求的头部和体格式必须匹配服务器预期：

Headers：一定要添加Content-Type: application/json，告诉服务器你发送的是JSON格式数据

Body：选择raw模式，下拉框里选JSON，然后输入对应格式的JSON内容，比如：

{
    "StudentId": 1,
    // 这里补充Student类的其他属性，比如"StudentName": "Alice"
}

3. Student类属性与JSON字段不匹配

如果你的Student类还有其他属性（比如姓名、年龄），要确保Postman里的JSON字段名和类的属性名一致（注意大小写：C#默认是PascalCase，要是JSON用camelCase的话，得做序列化配置）。比如补全后的Student类：

public class Student {
    public int StudentId { get; set; }
    public string StudentName { get; set; }
    public int Age { get; set; }
}

如果想用小写开头的JSON字段（比如studentId），可以给属性加[JsonProperty]特性（依赖Newtonsoft.Json）：

public class Student {
    [JsonProperty("studentId")]
    public int StudentId { get; set; }
    [JsonProperty("studentName")]
    public string StudentName { get; set; }
}