.NET 8 MVC站点复选框显示True/False而非勾选标记问题

核心原因 #

1. Razor视图里的复选框渲染逻辑对可空bool（bool?）和非可空bool不同，可空类型会默认输出文本值（True/False）而非复选框控件。
2. 移除Locked/Fenced的?时报错，本质是数据库里这两个字段存在NULL值——虽然字段有默认值，但可能历史数据或插入操作没触发默认值，导致NULL遗留，而非可空bool无法映射NULL。

具体解决步骤 #

方案1：保留可空bool，修复视图渲染 #

在Razor视图里手动控制复选框的选中状态，不要依赖默认模型绑定渲染：

<!-- 替代默认的 Html.CheckBoxFor(m => m.Locked) -->
<input type="checkbox" asp-for="Locked" checked="@Model.Locked.GetValueOrDefault()" />
<label asp-for="Locked"></label>

或者用三元表达式处理，同时添加隐藏字段确保未选中时提交false：

<input type="checkbox" id="Locked" name="Locked" value="true" 
       @(Model.Locked.HasValue && Model.Locked.Value ? "checked" : "") />
<input type="hidden" name="Locked" value="false" />
<label for="Locked">Locked</label>

方案2：清理数据库NULL值，改为非可空bool #

1. 先修复数据库里的NULL值（假设默认值为False/0）：

UPDATE Facility SET Locked = 0 WHERE Locked IS NULL;
UPDATE Facility SET Fenced = 0 WHERE Fenced IS NULL;

-- 可选：修改字段为非空，避免后续出现NULL
ALTER TABLE Facility ALTER COLUMN Locked BIT NOT NULL DEFAULT 0;
ALTER TABLE Facility ALTER COLUMN Fenced BIT NOT NULL DEFAULT 0;

2. 更新模型，移除Locked和Fenced的?：

public bool Locked { get; set; }
public bool Fenced { get; set; }

3. 执行EF Core迁移同步模型与数据库：

dotnet ef migrations update

方案3：修改EF Core脚手架生成规则（避免重复踩坑） #

如果经常用脚手架生成模型，可以在DbContext里配置，让bit类型默认映射为非可空bool：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Facility>()
        .Property(f => f.Locked)
        .IsRequired()
        .HasDefaultValue(false);
    
    modelBuilder.Entity<Facility>()
        .Property(f => f.Fenced)
        .IsRequired()
        .HasDefaultValue(false);
    
    // 其他模型配置...
}

之后重新生成模型时，这两个字段会直接生成为非可空bool。

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