Blazor WASM中泛型列表无法在模型间复制的问题排查

核心定位 #

你遇到的问题本质是API返回的JSON未正确反序列化为包含Properties列表的模型实例，导致后续复制操作无数据可处理（调试器进不去循环就是因为原列表为空或null），而非复制方法（直接赋值/AddRange/foreach）的问题。

分步排查与解决 #

1. 验证JSON结构与模型类的字段匹配
   先确认API返回的JSON中Properties字段的名称、层级是否和你的模型类一致。比如JSON里是"properties"（小写开头），而模型类里是public List<Property> Properties { get; set; }（大写开头），默认System.Text.Json区分大小写，会导致反序列化失败。
   解决：要么给模型字段加特性指定JSON字段名，要么开启大小写不敏感配置：

   // 方式1：给模型字段加特性
   public class ApiResponseModel
   {
       public int Id { get; set; }
       public string Title { get; set; }
       public string Description { get; set; }
       [JsonPropertyName("properties")] // 对应JSON里的字段名
       public List<Property> Properties { get; set; }
   }
   
   // 方式2：反序列化时开启大小写不敏感
   var options = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
   var apiModel = await JsonSerializer.DeserializeAsync<ApiResponseModel>(responseStream, options);
   

2. 检查Property类的反序列化兼容性
   System.Text.Json反序列化要求目标类必须有无参构造函数，如果Property类只有带参数的构造函数，会导致列表无法被正确实例化，最终为空。
   解决：给Property类添加无参构造函数：

   public class Property
   {
       // 必须保留无参构造函数
       public Property() {}
   
       // 你的带参构造函数（如果有）
       public Property(string key, string value)
       {
           Key = key;
           Value = value;
       }
   
       public string Key { get; set; }
       public string Value { get; set; }
   }
   

3. 确认API返回的原始JSON是否包含有效数据
   在Blazor中接收响应时，先读取原始JSON字符串，验证Properties数组是否存在且有数据：

   var response = await HttpClient.GetAsync("your-api-endpoint");
   var rawJson = await response.Content.ReadAsStringAsync();
   // 将rawJson输出到浏览器控制台或调试窗口，检查是否包含"Properties"或"properties"数组
   Console.WriteLine(rawJson);
   

   如果原始JSON里Properties本身就是空数组或null，那问题出在API端，需要排查API的返回逻辑。

4. 确保目标模型的Properties列表已初始化
   检查EditGenericLeafModel的Properties字段是否在构造函数中初始化，避免后续复制时出现空引用：

   public class EditGenericLeafModel
   {
       public EditGenericLeafModel()
       {
           // 初始化空列表，避免AddRange时出错
           Properties = new List<Property>();
       }
   
       public int Id { get; set; }
       [Required]
       public string Title { get; set; }
       public string Description { get; set; }
       public List<Property> Properties { get; set; }
   }
   

5. 复制数据的正确姿势
   确认原模型的Properties不为null后，再执行复制：

   // 先判断原列表是否有效
   if (apiModel.Properties != null)
   {
       editModel.Properties.AddRange(apiModel.Properties);
       // 或者用foreach逐个添加（和AddRange效果一致）
       // foreach (var prop in apiModel.Properties)
       // {
       //     editModel.Properties.Add(prop);
       // }
   }
   

内容的提问来源于stack exchange，提问作者iCollect.it Ltd