Keystone 6添加checkbox字段失败，数据库含null值无对应配置项如何解决？

问题根源 #

Keystone 6的checkbox字段本质映射为数据库的布尔类型，默认不允许存储null值。如果你的数据库对应字段已经存在null，同步时就会报错——这就是你遇到的问题。文本字段可以通过db.isNullable: true允许null，但checkbox字段本身不支持这个配置，因为布尔类型设计就是二元的（true/false）。

分步解决方案 #

1. 先清理数据库中的现有null值

先手动把数据库里对应字段的null替换为true或false，比如执行SQL语句（替换你的表名和字段名）：

UPDATE your_table_name SET checkbox_field = false WHERE checkbox_field IS NULL;

2. 正确配置Checkbox字段

给checkbox字段同时设置前端默认值和数据库层面的默认值，确保新创建的条目不会出现null，配置示例：

checkbox_field: checkbox({
  label: 'Checkbox Field',
  access: { read: () => true, update: () => true },
  defaultValue: false, // 前端表单默认选中状态
  db: {
    default: false // 数据库层面的默认值，确保插入时自动赋值
  }
}),

3. 特殊需求：必须允许null的情况（不推荐）

如果业务上确实需要保留null状态，可以用select字段模拟checkbox，这样就能开启db.isNullable：

checkbox_field: select({
  label: 'Checkbox Field',
  access: { read: () => true, update: () => true },
  options: [
    { label: '勾选', value: 'true' },
    { label: '不勾选', value: 'false' }
  ],
  ui: {
    displayMode: 'segmented-control' // 让选择器看起来像checkbox
  },
  db: {
    isNullable: true
  }
}),

为什么之前的尝试无效 #

• 只设置defaultValue：这只是前端表单的默认值，不会修改数据库中已存在的null，也没强制数据库插入时赋值
• db.map：这个配置是用来映射数据库字段名的，和null值问题无关

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