ASP.NET Core POST接口JSON无法转System.Int64及Unsupported Media Type错误求解
问题排查与解决方案
错误根源
- 「The JSON value could not be converted to System.Int64」错误核心诱因:
- 前后端字段命名不匹配:后端Order类的
Pmethod、Gtotal字段与前端定义的pMethod、gTotal命名不一致,导致字段绑定失败;新增场景下前端未给非可空主键orderId、orderItemId赋值,传递null/undefined到后端后无法转换为long类型 - 前端传递了字符串格式的数值(如
"123"),后端默认序列化规则不支持直接将字符串转为数字类型
- 「Unsupported Media Type」错误诱因:
使用JSON.stringify将请求体转为字符串后,Angular HttpClient不会自动添加Content-Type: application/json请求头,后端无法识别请求体格式。
解决步骤
1. 修复前端请求逻辑
- 优先选择直接传递JSON对象,无需手动调用
JSON.stringify,HttpClient会自动设置正确的请求头:
saveOrUpdateOrder() { // 新增场景下删除未赋值的主键字段,避免传递null const postData = { ...this.formData, // 对齐后端字段名 pmethod: this.formData.pMethod, gtotal: this.formData.gTotal, OrderItems: this.orderItems.map(item => { // 新增时删除未赋值的主键,避免传递null if (!item.orderItemId) delete item.orderItemId; if (!item.orderId) delete item.orderId; return item; }) }; // 删除前端多余的、后端不存在的字段 delete postData.pMethod; delete postData.gTotal; return this.http.post<any>(this.apiUrl + '/Orders', postData); }
- 若确需使用
JSON.stringify,需手动添加请求头:
const body = JSON.stringify(postData); return this.http.post<any>(this.apiUrl + '/Orders', body, { headers: { 'Content-Type': 'application/json' } });
2. 后端序列化配置(ASP.NET Core)
在Program.cs中配置System.Text.Json序列化规则,兼容字段大小写不敏感匹配、支持字符串转数字:
builder.Services.AddControllers() .AddJsonOptions(options => { // 忽略属性名大小写,兼容前后端命名差异 options.JsonSerializerOptions.PropertyNameCaseInsensitive = true; // 允许读取字符串格式的数字 options.JsonSerializerOptions.NumberHandling = System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString; });
如果使用NewtonsoftJson,配置规则如下:
builder.Services.AddControllers() .AddNewtonsoftJson(options => { // 自动转换驼峰命名 options.SerializerSettings.ContractResolver = new Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver(); });
3. 可选优化
如果OrderId、OrderItemId为数据库自增主键,可在后端属性上添加[JsonIgnore]特性,避免前端传递的无效值影响绑定:
public partial class Order { [JsonIgnore] public long OrderId { get; set; } // 其余属性不变 }
内容的提问来源于stack exchange,提问作者Can Çatalbaş
相关产品推荐
相关产品推荐

