ASP.NET REST服务中List<string>序列化为Null问题排查

看起来你遇到了两个核心问题：一是ASP.NET Web API无法正确绑定POST请求中的BookISBN数组到模型，二是Entity Framework没有为List<string>类型的字段生成数据库列。下面一步步来解决：

1. 为什么BookISBN会被序列化为null？ #

常见原因： #

• 集合未初始化：你的BookISBN属性没有默认初始化，默认值是null。如果模型绑定过程中出现任何小问题，就会保持null状态。
• 请求头配置错误：Postman发送请求时，没有设置正确的Content-Type: application/json头，导致Web API无法正确解析JSON格式的请求体。
• 模型绑定错误：可以通过检查ModelState的错误信息来确认具体原因——比如是否有序列化失败的提示。

快速修复绑定问题： #

首先在模型的构造函数中初始化集合，避免默认null：

public class Bookings {
    public Bookings() {
        // 初始化空列表，避免null
        BookISBN = new List<string>();
    }

    [Key]
    public int BookingId { get; set; }
    [Required]
    public int UserID { get; set; }
    public List<string> BookISBN { get; set; }
}

然后检查Postman的请求配置：

• 确保请求方法是POST
• 在Headers标签中添加Content-Type: application/json
• 在Body标签中选择raw并设置格式为JSON

另外，你可以临时修改控制器代码，返回ModelState的错误信息来排查绑定问题：

[ResponseType(typeof(Bookings))]
public IHttpActionResult PostBooking(Bookings Booking) {
    if (!ModelState.IsValid) {
        // 返回具体的模型错误，方便排查
        return BadRequest(ModelState);
    }
    db.Bookings.Add(Booking);
    db.SaveChanges();
    return CreatedAtRoute("DefaultApi", new { id = Booking.BookingId }, Booking);
}

2. 为什么数据库没有生成BookISBN对应的列？ #

关系型数据库（比如SQL Server）没有直接对应List<string>这种集合类型的字段，而Entity Framework默认不会自动处理这种复杂类型的映射——它会直接忽略这个属性，所以不会生成对应的列。

解决方案：将集合序列化为JSON字符串存储 #

我们可以把List<string>序列化为JSON字符串，存储在一个nvarchar(max)类型的数据库列中，然后在模型中做自动的序列化/反序列化处理：

1. 安装Newtonsoft.Json包（Web API 2默认依赖这个，但如果没有的话需要手动安装）
2. 修改模型代码：

using Newtonsoft.Json;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations.Schema;

public class Bookings {
    public Bookings() {
        BookISBN = new List<string>();
    }

    [Key]
    public int BookingId { get; set; }
    [Required]
    public int UserID { get; set; }

    // 这个属性不会映射到数据库
    [NotMapped]
    public List<string> BookISBN { get; set; }

    // 数据库中实际存储的JSON列
    [Column("BookISBN", TypeName = "nvarchar(max)")]
    public string BookISBNJson {
        get => JsonConvert.SerializeObject(BookISBN);
        set => BookISBN = string.IsNullOrEmpty(value) ? new List<string>() : JsonConvert.DeserializeObject<List<string>>(value);
    }
}

这样EF会为BookISBNJson生成数据库列，而BookISBN作为业务逻辑中使用的集合，会自动和数据库中的JSON字符串做转换。

最后验证 #

修改完成后，重新运行项目，用Postman发送正确配置的POST请求：

• 确保Content-Type是application/json
• 请求体保持你原来的JSON格式

此时BookISBN应该能正确绑定，并且数据库中会生成BookISBNJson列，存储序列化后的JSON数组。

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