> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Could not locate the bindings file: corregir 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](https://www.npmjs.com/package/better-sqlite3) y, si lo utilizas, [quick.db](https://www.npmjs.com/package/quick.db).

**2. Actualiza tu `package.json`.**

```jsonc
"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.**