ModelState未验证必填字段：ProductTypeId未触发非侵入式验证

问题描述 #

我定义了Product、ProductType和ProductsProductType三个实体类，在ProductsProductType的Razor创建页面中，ModelState仅验证了标记[Required]的ProductId属性，完全忽略了ProductTypeId。当我留空ProductTypeId的下拉框时，不会触发预期的非侵入式必填提示，反而在保存时抛出Entity Framework错误：

尝试保存更改时，'ProductProductType.ProductTypeId'的值未知。这是因为该属性同时属于一个外键，而该关系中的主体实体未知。

核心原因 #

1. 值类型默认值干扰：ProductTypeId是值类型int，默认值为0，而[Required]特性对于值类型来说，0会被判定为有效输入，因此ModelState不会将其标记为错误，直接进入保存逻辑。
2. 下拉框默认值问题：原下拉框的默认选项虽然是disabled selected，但未设置value=""，提交时会传递0值而非null，进一步导致[Required]无法触发。
3. EF配置属性名不一致：原DatabaseContext中配置外键时使用了ProductTypeID（大写D），但实体类中属性名为ProductTypeId（小写d），这会导致EF映射异常，加重验证问题。

解决方案 #

1. 修改实体类外键为可空值类型 #

将ProductsProductType中的ProductTypeId改为可空int?，这样未选择下拉框时值为null，[Required]会正确识别并触发验证：

public partial class ProductsProductType
{
    [Required]
    public int ProductId { get; set; }

    [Required(ErrorMessage = "请选择产品类型")]
    [Display(Name = "产品类型")]
    public int? ProductTypeId { get; set; }

    public virtual Product? Product { get; set; } = null!;
    public virtual ProductType? ProductType { get; set; } = null!;
}

2. 修正EF上下文的属性名映射 #

确保DatabaseContext中的外键配置与实体类属性名一致，同时保留IsRequired()以保证数据库层面的约束：

modelBuilder.Entity<ProductsProductType>(entity =>
{
    entity.HasKey(e => new { e.ProductId, e.ProductTypeId }).HasName("PK_Products_Product_Types");

    entity.ToTable("Products_Product_Types");

    entity.Property(e => e.ProductId).HasColumnName("ProductID");
    entity.Property(e => e.ProductTypeId).HasColumnName("ProductTypeID"); // 修正属性名为ProductTypeId

    entity.HasOne(f => f.Product).WithMany(e => e.ProductsProductTypes)
        .HasForeignKey(f => f.ProductId).IsRequired()
        .OnDelete(DeleteBehavior.ClientSetNull)
        .HasConstraintName("FK_Products_Product_Types_Products");

    entity.HasOne(f => f.ProductType).WithMany(e => e.ProductsProductTypes)
        .HasForeignKey(f => f.ProductTypeId).IsRequired() // 使用正确的属性名ProductTypeId
        .OnDelete(DeleteBehavior.ClientSetNull)
        .HasConstraintName("FK_Product_Product_Types_Product_Types");
});

3. 优化下拉框默认选项 #

设置默认选项的value=""，确保未选择时提交null值：

<select asp-for="ProductsProductType.ProductTypeId" class="form-control" asp-items="ViewBag.ProductTypes">
    <option value="" disabled selected>- 选择产品类型 -</option>
</select>

4. 确保客户端验证脚本已加载 #

在页面或布局中引入jQuery及非侵入式验证脚本，保证客户端验证生效：

<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>

5. 验证后端逻辑 #

确认后端在ModelState无效时重新返回页面并填充下拉框数据，原代码已实现此逻辑，可保持不变：

[BindProperty]
public ProductsProductType ProductsProductType { get; set; } = default!;

public async Task<IActionResult> OnPostProductProductTypeCreateAsync()
{
    if (!ModelState.IsValid || _context.ProductsProductTypes == null || ProductsProductType == null)
    {
        ViewBag.ProductId = ProductsProductType.ProductId;
        ViewBag.ProductTypes = new SelectList(_context.ProductTypes, nameof(ProductType.ProductTypeId), nameof(ProductType.ProductTypeName));
        return Page();
    }

    _context.ProductsProductTypes.Add(ProductsProductType);
    await _context.SaveChangesAsync();

    return Page();
}

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