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

Offen Anfängerfreundlich
#2,918 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 2 Tagen

@SibilSoren arbeitet bereits daran.

Seit 17.11.2026.

  • #2924 von @SibilSoren — offen

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
88/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
mysql, sql, typescript
Bereich
database

Rechercherichtung

Der Fehler steckt im Boolean-Fall von transformInput in packages/orm/src/client/crud/dialects/mysql.ts, der value ? 1 : 0 ohne Null-Prüfung zurückgibt. Vergleiche ihn mit dem Decimal-Fall im selben switch, der bereits auf null prüft. Füge dem Boolean-Fall dieselbe Prüfung hinzu und ergänze dann einen Regressionstest, der beim Erstellen und Aktualisieren null schreibt und erwartet, dass die Spalte NULL ist. Fertig ist es, wenn der Test besteht und der Client flag: null zurückgibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.

Vorherrschende Sprache
TypeScript
Sterne
2.9k
Forks
157
Ø Merge
5 T. 11 Std.
Gemergte PRs (30 T.)
20

Entwicklungsumgebung

Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus zenstackhq/zenstack

Alle Issues in zenstackhq/zenstack

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.