> ## 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: corrigir better-sqlite3

**Solução rápida:** atualize o `better-sqlite3` (e bibliotecas que dependem dele, como o `quick.db`) para a última versão, apague `node_modules` e `package-lock.json` e reinicie a aplicação. Passo a passo completo abaixo.

## O que significa esse erro

Quando sua aplicação usa o `better-sqlite3` (diretamente ou através de uma biblioteca que depende dele, como o `quick.db`), ela pode falhar na inicialização com um erro como este:

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

Em resumo: o `better-sqlite3` não conseguiu carregar seu binário nativo (as "bindings"), o que quase sempre significa que a versão instalada é antiga demais para a versão do Node.js que está rodando sua aplicação.

## Por que acontece

Versões antigas do `better-sqlite3` **não suportam o Node.js LTS v24.x**. Quando a plataforma roda sua aplicação em um Node.js mais novo, o pacote desatualizado não encontra um binário compilado compatível e lança esse erro.

## Como resolver

**1. Confira a última versão das bibliotecas.**

Veja as versões atuais no npm: [better-sqlite3](https://www.npmjs.com/package/better-sqlite3) e, se você usar, [quick.db](https://www.npmjs.com/package/quick.db).

**2. Atualize seu `package.json`.**

```jsonc
"better-sqlite3": "^12.5.0",
"quick.db": "^9.1.7" // ou outra biblioteca que dependa do better-sqlite3
```

Ou pelo terminal: `npm install better-sqlite3@latest`.

**3. Force uma instalação limpa.**

Apague `node_modules`, `package-lock.json` e a pasta `.npm` para que as dependências sejam reinstaladas do zero.

**4. Reinicie a aplicação.**

## Ainda não inicia?

Se a aplicação ainda não subir após a atualização, a causa pode estar em outro lugar — veja [Minha aplicação não inicia: Verificando o script de start](https://help.squarecloud.app/pt-br/article/minha-aplicacao-nao-inicia-verificando-o-script-de-start-1ospfjh/). Se o erro mencionar um pacote que não foi encontrado, veja [MODULE_NOT_FOUND / Cannot find module: como resolver](https://help.squarecloud.app/pt-br/article/modulenotfound-cannot-find-module-como-resolver-4tjbza/).