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

Aperta Adatta ai principianti
#2,918 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

@SibilSoren ci sta già lavorando.

Dal 17/11/2026.

  • #2924 di @SibilSoren — aperta

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
88/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
mysql, sql, typescript
Ambito
database

Direzione di ricerca

Il bug si trova nel caso Boolean di transformInput in packages/orm/src/client/crud/dialects/mysql.ts, che restituisce value ? 1 : 0 senza un controllo su null. Confrontalo con il caso Decimal nello stesso switch, che invece controlla già null. Aggiungi lo stesso controllo al caso Boolean, poi aggiungi un test di regressione che scriva null in creazione e in aggiornamento e che si aspetti che la colonna sia NULL. È completato quando il test passa e il client restituisce flag: null.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
TypeScript
Stelle
2.9k
Fork
157
Merge medio
5g 11h
PR unite (30g)
20

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di zenstackhq/zenstack

Tutte le issue di zenstackhq/zenstack

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.