---
id: gh-better-sqlite3-rebuild
name: "better-sqlite3-rebuild"
url: https://skills.yangsir.net/skill/gh-better-sqlite3-rebuild
author: mattpocock
domain: ai-dev-tools-workflow
tags: ["better-sqlite3", "native-module", "node-version", "troubleshooting", "npm-rebuild"]
install_count: 101
rating: 4.00 (120 reviews)
github: https://github.com/mattpocock/ai-engineer-workshop-2026-project/tree/main/.claude/skills/better-sqlite3-rebuild
---

# better-sqlite3-rebuild

> 此技能用于在遇到 better-sqlite3 原生模块报错时自动执行 npm rebuild 并重试，覆盖 NODE_MODULE_VERSION 不匹配、原生绑定加载失败等常见问题。它让 AI 代理无需询问用户即可自愈依赖问题，显著缩短排查与修复时间，保持开发流程不中断。

**Stats**: 101 installs · 4.0/5 (120 reviews)

## Before / After 对比

### 原生模块版本不匹配的修复效率

**Before**:

开发者看到 NODE_MODULE_VERSION 不匹配或原生绑定加载失败时，往往先怀疑代码问题，反复搜索报错、手动删除 node_modules 重装、切换 Node 版本，整个排查链路常常耗掉半小时以上。

**After**:

此技能识别到同类原生模块报错后直接执行 npm rebuild 并重试，无需用户确认，通常一次重建即恢复可用，开发者不必中断当前任务去手动折腾依赖环境。

| Metric | Before | After | Change |
|---|---|---|---|
| 平均修复耗时 | 45分钟 | 1分钟 | -98% |
| 排查决策步骤 | 6步 | 1步 | -83% |

## Readme

# better-sqlite3 Rebuild

When you encounter errors related to `better-sqlite3` and Node.js version mismatches (e.g. `NODE_MODULE_VERSION` mismatch, "was compiled against a different Node.js version", native module load failures), proactively fix by running:

```sh
npm rebuild
```

Do this without asking the user first - just rebuild and retry.


---
*Source: https://skills.yangsir.net/skill/gh-better-sqlite3-rebuild*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-better-sqlite3-rebuild/markdown*