含一对多关系的C#类无法通过Swagger创建记录的问题排查

一、代码中的潜在问题 #

• 导航属性命名不规范：Address和Room中的导航属性hotel采用小写开头，虽EF Core可识别关联关系，但不符合C# PascalCase命名规范，建议改为Hotel，同时将ForeignKey属性调整为[ForeignKey(nameof(Hotel))]，提升代码可读性。
• 集合未初始化：Hotel类中的HotelAddresses和Rooms集合未初始化，直接添加子实体时会触发空引用异常。建议在Hotel构造函数中初始化集合：

public Hotel()
{
    HotelAddresses = new List<Address>();
    Rooms = new List<Room>();
}

• 直接使用实体作为请求参数：Post方法接收Hotel实体类，导致Swagger展示自动生成的ID字段（如AddressId、RoomId），这些字段本应由数据库自动生成，无需用户输入。

二、带外键的记录创建方式 #

方式1：嵌套创建（一次性保存酒店及关联实体） #

构造包含关联地址和房间的Hotel对象，EF Core会自动处理外键赋值与ID生成：

var newHotel = new Hotel
{
    HotelName = "测试酒店",
    Stars = 3,
    HotelAddresses = new List<Address>
    {
        new Address { Country = "中国", City = "上海", Street = "XX路123号" }
    },
    Rooms = new List<Room>
    {
        new Room { Name = "标准间", Description = "舒适单人房", price = 299 }
    }
};

_context.Hotels.Add(newHotel);
await _context.SaveChangesAsync();
// 此时newHotel.HotelId、所有AddressId、RoomId会被自动赋值

方式2：分步创建（先保存酒店，再保存关联实体） #

先创建并保存酒店获取ID，再以此ID为外键创建地址和房间：

// 1. 创建并保存酒店
var hotel = new Hotel { HotelName = "测试酒店", Stars = 4 };
_context.Hotels.Add(hotel);
await _context.SaveChangesAsync();

// 2. 创建地址并关联酒店ID
var address = new Address { Country = "中国", City = "北京", Street = "YY街456号", HotelId = hotel.HotelId };
_context.Addresses.Add(address);

// 3. 创建房间并关联酒店ID
var room = new Room { Name = "豪华套房", Description = "带阳台的套房", price = 899, HotelId = hotel.HotelId };
_context.Rooms.Add(room);

await _context.SaveChangesAsync();

三、解决Swagger要求填写自动生成ID的问题 #

核心方案是使用DTO（数据传输对象）替代实体类作为请求参数，DTO仅保留需用户输入的字段，隐藏自动生成的ID：

1. 创建DTO类 #

// 创建酒店的DTO
public class CreateHotelDto
{
    [Column(TypeName = "nvarchar(50)")]
    public string HotelName { get; set; }

    [Range(1,5,ErrorMessage = "Hotel Star Rating Value Must be in between of 1 and 5.")]
    public byte Stars { get; set; }

    public List<CreateAddressDto> HotelAddresses { get; set; }
    public List<CreateRoomDto> Rooms { get; set; }
}

// 创建地址的DTO
public class CreateAddressDto
{
    [Column(TypeName = "nvarchar(50)")]
    public string Country { get; set; }

    [Column(TypeName = "nvarchar(50)")]
    public string City { get; set; }

    [Column(TypeName = "nvarchar(50)")]
    public string Street { get; set; }
}

// 创建房间的DTO
public class CreateRoomDto
{
    [Column(TypeName ="nvarchar(50)")]
    public string Name { get; set; }

    [Column(TypeName = "nvarchar(250)")]
    public string Description { get; set; }

    public decimal price { get; set; }
}

2. 修改控制器Post方法 #

[HttpPost]
public async Task<ActionResult<Hotel>> PostHotel(CreateHotelDto hotelDto)
{
    // 将DTO映射为实体
    var hotel = new Hotel
    {
        HotelName = hotelDto.HotelName,
        Stars = hotelDto.Stars,
        HotelAddresses = hotelDto.HotelAddresses.Select(a => new Address
        {
            Country = a.Country,
            City = a.City,
            Street = a.Street
        }).ToList(),
        Rooms = hotelDto.Rooms.Select(r => new Room
        {
            Name = r.Name,
            Description = r.Description,
            price = r.price
        }).ToList()
    };

    _context.Hotels.Add(hotel);
    await _context.SaveChangesAsync();

    return CreatedAtAction("GetHotel", new { id = hotel.HotelId }, hotel);
}

修改后Swagger仅展示DTO中的字段，不会要求用户输入自动生成的ID，EF Core也会自动处理关联实体的外键与ID生成。

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