Could not locate the bindings file: cómo corregir el error de better-sqlite3

Solución rápida: actualiza better-sqlite3 (y las bibliotecas que dependen de él, como quick.db) a la última versión, elimina node_modules y package-lock.json y reinicia la aplicación. El paso a paso completo se encuentra abajo.

Qué significa este error

Cuando tu aplicación utiliza better-sqlite3 (ya sea directamente o a través de una biblioteca que depende de él, como quick.db), puede fallar durante el inicio con un error como este:

Error: Could not locate the bindings file. Tried:
 → /application/node_modules/better-sqlite3/build/better_sqlite3.node
 ...

En resumen: better-sqlite3 no pudo cargar su binario nativo (los "bindings"), lo que casi siempre significa que la versión instalada es demasiado antigua para la versión de Node.js que está ejecutando tu aplicación.

Por qué ocurre

Las versiones antiguas de better-sqlite3 no son compatibles con Node.js LTS v24.x. Cuando la plataforma ejecuta tu aplicación en una versión de Node.js más reciente, el paquete desactualizado no encuentra un binario compilado compatible y lanza este error.

Cómo resolverlo

1. Verifica la última versión de las bibliotecas.

Consulta las versiones actuales en npm: better-sqlite3 y, si lo utilizas, quick.db.

2. Actualiza tu package.json.

"better-sqlite3": "^12.5.0",
"quick.db": "^9.1.7" // u otra biblioteca que dependa de better-sqlite3

O desde la terminal: npm install better-sqlite3@latest.

3. Fuerza una instalación limpia.

Elimina node_modules, package-lock.json y la carpeta .npm para que las dependencias se reinstalen desde cero.

4. Reinicia la aplicación.

Actualizado el: 12/06/2026