Asp.net Core API：无法同时录入客户多条地址与电话数据求助

一、确认实体类及EF关系配置 #

首先确保实体类和EF Core的关联关系配置正确，这是批量保存关联数据的基础：

实体类定义示例 #

public class Customer
{
    public int CId { get; set; }
    public string Name { get; set; } // 示例业务字段，根据实际需求调整
    // 导航属性必须声明为ICollection<T>类型，建议初始化空集合避免空引用
    public ICollection<Address> Adresses { get; set; } = new List<Address>();
    public ICollection<Phone> Phones { get; set; } = new List<Phone>();
}

public class Address
{
    public int Id { get; set; }
    public string Street { get; set; } // 示例地址字段
    // 外键字段，关联Customer的主键CId
    public int CustomerId { get; set; }
    public Customer Customer { get; set; }
}

public class Phone
{
    public int Id { get; set; }
    public string Number { get; set; } // 示例电话字段
    public int CustomerId { get; set; }
    public Customer Customer { get; set; }
}

EF Core Fluent API关系配置（推荐） #

在你的DbContext类中添加关系配置，明确一对多关联规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置Customer与Address的一对多关系
    modelBuilder.Entity<Customer>()
        .HasMany(c => c.Adresses)
        .WithOne(a => a.Customer)
        .HasForeignKey(a => a.CustomerId)
        .OnDelete(DeleteBehavior.Cascade); // 级联删除规则，按需调整

    // 配置Customer与Phone的一对多关系
    modelBuilder.Entity<Customer>()
        .HasMany(c => c.Phones)
        .WithOne(p => p.Customer)
        .HasForeignKey(p => p.CustomerId)
        .OnDelete(DeleteBehavior.Cascade);
}

二、调整POST请求及模型绑定 #

你的现有POST方法逻辑基本可行，但需要确保请求格式正确，且ASP.NET Core能正确识别嵌套集合。

正确的请求JSON示例（POST请求体） #

{
    "name": "张三",
    "adresses": [
        {
            "street": "XX街道1号"
        },
        {
            "street": "XX街道2号"
        }
    ],
    "phones": [
        {
            "number": "13800138000"
        },
        {
            "number": "13900139000"
        }
    ]
}

注意：不要手动设置子实体的CustomerId，新增Customer时如果CId是自增主键，EF Core会自动为子实体填充外键值。

修复序列化与绑定问题 #

如果遇到循环引用（返回数据时Customer包含Addresses，Addresses又反向引用Customer）或大小写不匹配的绑定问题，在Program.cs中配置JSON序列化：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        options.JsonSerializerOptions.PropertyNameCaseInsensitive = true; // 允许大小写不敏感的字段绑定
    });

三、优化POST方法（可选） #

为避免空引用异常，可在POST方法中确保集合初始化：

[HttpPost]
public async Task<ActionResult<Customer>> PostCustomer(Customer customer)
{
    // 确保关联集合不为空
    customer.Adresses ??= new List<Address>();
    customer.Phones ??= new List<Phone>();
    
    _context.Customers.Add(customer);
    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateException)
    {
        if (CustomerExists(customer.CId))
        {
            return Conflict();
        }
        else
        {
            throw;
        }
    }

    return CreatedAtAction("GetCustomer", new { id = customer.CId }, customer);
}

四、常见问题排查 #

• 模型绑定失败：检查请求JSON字段名与实体类属性名是否匹配，或开启PropertyNameCaseInsensitive配置
• 子实体未保存：确认EF关系配置正确，子实体的外键字段存在且未被设置为无效值
• 主键冲突：如果CId是自增列，不要在请求中传入CId值，让数据库自动生成主键

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