El bug que me tomó tres días encontrar (y la lección que me dejó)

El bug era simple de describir y horrible de encontrar: a veces, solo a veces, un formulario no guardaba los cambios. No había ningún error visible en la consola.

Día uno: culpar a todo menos al código correcto

Revisé la base de datos, revisé los permisos, revisé si era un problema de caché del navegador. Nada.

Día dos: reproducirlo por fin

Encontré el patrón: solo pasaba cuando el usuario escribía muy rápido y enviaba el formulario antes de que terminara una validación asíncrona en segundo plano.

// la validación devolvía una promesa que nadie esperaba
async function validarCampo(valor) {
  const resultado = await revisarDisponibilidad(valor);
  // el submit ya había pasado para cuando esto terminaba
}

Día tres: la solución

Bastaron cuatro líneas: bloquear el botón de enviar mientras la validación estuviera en curso. Cuatro líneas para tres días de trabajo.

La mayoría de los bugs difíciles no son difíciles de arreglar, son difíciles de encontrar. Una vez que entiendes el patrón, la solución casi siempre es simple.