保存关联值为空的Product时出现CategoryId值无效错误如何解决

问题根因 #

1. 当前Product模型里的CategoryId、ProviderId、BranchId都是非空值类型int，EF Core默认会将其视为必填外键，提交空值时无法转换为int类型，就会触发你看到的校验错误。
2. 接口逻辑里直接用Single查询对应Id的关联数据，当Id为空时查询必然失败，而且你当前的异常处理直接吞掉所有异常返回NoContent，不方便排查问题。

解决方案 #

步骤1：修改Product模型的外键为可空类型 #

把三个外键属性的类型从int改为int?（可空int），这样就支持不关联对应数据的场景：

public class Product
{
    [Key]
    public int Id { get; set; }

    [Required]
    public string Name { get; set; }

    [Required]
    public string Codebar { get; set; }

    public DateTime CreatedDate { get; set; }

    public int Stock { get; set; }

    [Required]
    public int Price { get; set; }

    // 改为可空int，支持无关联的场景
    public int? CategoryId { get; set; }
    public Category Category { get; set; }

    public int? ProviderId { get; set; }
    public Provider Provider { get; set; }

    public int? BranchId { get; set; }
    public Branch Branch { get; set; }
}

修改完成后需要执行一次EF迁移，更新数据库表结构，把三个外键字段改为可空。

步骤2：修改Post接口的关联查询逻辑 #

查询关联对象前先判断DTO对应Id是否有值，避免空Id查询抛出异常：

public async Task<ActionResult<Product>> PostProduct([FromForm]ProductDTO productDTO)
{
    try
    {
        Product newProduct = new Product
        {
            Name = productDTO.Name,
            Stock = productDTO.Stock,
            CreatedDate = DateTime.UtcNow,
            Price = productDTO.Price,
            Codebar = productDTO.Codebar
        };

        // 分类Id有值才查询赋值
        if (productDTO.CategoryId.HasValue)
        {
            newProduct.Category = _context.Category.Single(x => x.Id == productDTO.CategoryId.Value);
        }
        // 供应商Id有值才查询赋值
        if (productDTO.ProviderId.HasValue)
        {
            newProduct.Provider = _context.Provider.Single(x => x.Id == productDTO.ProviderId.Value);
        }
        // 门店Id有值才查询赋值
        if (productDTO.BranchId.HasValue)
        {
            newProduct.Branch = _context.Branch.Single(x => x.Id == productDTO.BranchId.Value);
        }
                
        _context.Products.Add(newProduct);
        await _context.SaveChangesAsync();
        return CreatedAtAction("GetProduct", 
            new { id = newProduct.Id }, newProduct);
    }
    catch (Exception e)
    {
        // 不要直接吞异常返回NoContent，返回对应错误信息方便排查
        return BadRequest(new { message = "创建商品失败", error = e.Message });
    }
}

步骤3：同步修改ProductDTO的对应属性 #

确保接收参数的ProductDTO里的CategoryId、ProviderId、BranchId也都是int?类型，否则参数绑定时就会触发空值转换错误。
如果业务规则要求分类必须选、供应商和门店可选，只需要给CategoryId加上[Required]特性即可，另外两个保持可空不加。

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