MySQL: null on an optional Boolean field is written as false

Abierto Apto para principiantes
#2,918 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

@SibilSoren ya está trabajando en esto.

Desde el 17/11/2026.

  • #2924 de @SibilSoren — abierto

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
88/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
mysql, sql, typescript
Área
database

Línea de trabajo

El error está en el caso Boolean de transformInput en packages/orm/src/client/crud/dialects/mysql.ts, que devuelve value ? 1 : 0 sin comprobar null. Compáralo con el caso Decimal del mismo switch, que ya comprueba null. Añade la misma comprobación al caso Boolean y luego agrega una prueba de regresión que escriba null al crear y al actualizar y que espere que la columna sea NULL. Está terminado cuando la prueba pasa y el cliente devuelve flag: null.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Description and expected behavior

On MySQL, writing null to an optional Boolean? field stores 0 instead of NULL. This happens on both create and update, with a bare ZenStackClient and no plugins. Expected: the column is NULL and the client returns flag: null.

Schema:

datasource db {
  provider = 'mysql'
  url      = env('DATABASE_URL')
}

model ZsBoolRepro {
  id   Int      @id @default(autoincrement())
  flag Boolean?
}

Repro:

import { ZenStackClient } from '@zenstackhq/orm'
import { MysqlDialect } from '@zenstackhq/orm/dialects/mysql'
import { createPool } from 'mysql2'
import { schema } from './zenstack/schema'

const db = new ZenStackClient(schema, {
  dialect: new MysqlDialect({ pool: createPool({ uri: process.env.DATABASE_URL }) }),
})

const created = await db.zsBoolRepro.create({ data: { flag: true } })
await db.zsBoolRepro.update({ where: { id: created.id }, data: { flag: null } })
await db.zsBoolRepro.create({ data: { flag: null } })
console.log(await db.$queryRawUnsafe('SELECT id, flag FROM ZsBoolRepro'))

Output:

after update to null: { id: 1, flag: false }
created with null:    { id: 2, flag: false }
raw rows: [ { id: 1, flag: 0 }, { id: 2, flag: 0 } ]

The cause looks like transformInput in the MySQL dialect (packages/orm/src/client/crud/dialects/mysql.ts). Its Boolean case is return value ? 1 : 0; with no null check, so null becomes 0. The Decimal case in the same switch already guards null (value !== null ? value.toString() : value). A matching guard on the Boolean case should fix it, and I'm happy to open a PR with a regression test if that helps.

Screenshots

N/A

Environment (please complete the following information):

  • ZenStack version: 3.10.1 (the Boolean case is unchanged on main)
  • Database type: MySQL 8.0.44
  • Node.js/Bun version: Node 24.13.1
  • Package manager: pnpm 10.25.0

Additional context

Since the field is optional, the input validator accepts null, so nothing errors and the wrong value is saved silently. In our app, this means a user can't clear a yes/no field once it's set.

Lenguaje dominante
TypeScript
Estrellas
2.9k
Forks
157
Merge medio
5 d 11 h
PR fusionados (30 d)
20

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de zenstackhq/zenstack

Todos los issues de zenstackhq/zenstack

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.