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 e, se você usar, quick.db.

2. Atualize seu package.json.

"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. Se o erro mencionar um pacote que não foi encontrado, veja MODULE_NOT_FOUND / Cannot find module: como resolver.

Atualizado em: 13/06/2026