Symfony 6.3中MapRequestPayload处理POST关联实体的方法

方法1：手动提取请求体中的company_id关联实体 #

在MapRequestPayload完成基础属性映射后，直接从请求体中取出company_id，查询对应Company实体并关联：

public async Task<IActionResult> CreatePerson([MapRequestPayload] Person person, [FromBody] JObject requestBody)
{
    if (requestBody.TryGetValue("company_id", out var companyIdToken) && int.TryParse(companyIdToken.ToString(), out int companyId))
    {
        var targetCompany = await _dbContext.Companies.FindAsync(companyId);
        if (targetCompany != null)
        {
            person.Company = targetCompany;
        }
        else
        {
            ModelState.AddModelError("company_id", "指定的公司不存在");
            return BadRequest(ModelState);
        }
    }

    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    _dbContext.Persons.Add(person);
    await _dbContext.SaveChangesAsync();
    return Ok(person);
}

方法2：配置MapEntity属性的数据源（若支持） #

如果你的MapEntity属性允许指定数据源，直接修改它从请求体而非查询参数获取值：

public class Person
{
    public int Id { get; set; }
    public string FullName { get; set; }
    
    // 假设属性支持指定Source为Body
    [MapEntity(Source = RequestSource.Body)]
    public Company Company { get; set; }
}

方法3：用DTO中转（推荐方案） #

定义包含company_id的DTO，在控制器中完成实体关联逻辑，避免直接操作实体映射的局限性：

// 定义DTO
public class PersonCreateDto
{
    [Required]
    public string FullName { get; set; }
    
    [Required]
    public int CompanyId { get; set; }
}

// 控制器逻辑
public async Task<IActionResult> CreatePerson([FromBody] PersonCreateDto dto)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    var company = await _dbContext.Companies.FindAsync(dto.CompanyId);
    if (company == null)
    {
        ModelState.AddModelError("CompanyId", "公司不存在");
        return BadRequest(ModelState);
    }

    var person = new Person
    {
        FullName = dto.FullName,
        Company = company
    };

    _dbContext.Persons.Add(person);
    await _dbContext.SaveChangesAsync();
    return Ok(person);
}

方法4：通过AutoMapper配置映射规则 #

如果项目使用AutoMapper，可在映射配置中直接处理CompanyId到Company的关联：

// AutoMapper配置
CreateMap<PersonCreateDto, Person>()
    .ForMember(dest => dest.Company, opt => 
        opt.ResolveUsing(async (src, _, __, context) => 
            await context.GetContext<AppDbContext>().Companies.FindAsync(src.CompanyId)));

// 控制器中使用
public async Task<IActionResult> CreatePerson([FromBody] PersonCreateDto dto)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    var person = _mapper.Map<Person>(dto);
    _dbContext.Persons.Add(person);
    await _dbContext.SaveChangesAsync();
    return Ok(person);
}

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