解决 better-sqlite3 连接 SQLite 时报错 Could not locate the bindings file
内容提要
在迁移服务器时，better-sqlite3 连接 SQLite 报错“找不到绑定文件”，原因是缺少编译好的二进制文件。通过手动构建 better_sqlite3.node 文件解决了该问题，确保服务正常运行。
关键要点
-
在迁移服务器时，发现 better-sqlite3 连接 SQLite 报错，原因是缺少编译好的二进制文件。
-
迁移工作相对简单，主要是修改 Workflow 的目标机器 IP 和 SSH Key，重新运行 CI 打包。
-
Docker 容器运行后，访问接口报错，提示找不到 bindings 文件。
-
better-sqlite3 需要编译原生绑定文件，缺少 better_sqlite3.node 文件导致连接失败。
-
通过手动构建 better_sqlite3.node 文件解决了该问题，确保服务正常运行。
-
CI 机器的新系统环境缺少一些预装的依赖，导致 node-gyp build 没有执行成功。
-
建议在选择服务器操作系统时，优先考虑稳定性，Debian 是一个不错的选择。
延伸解读
迁移服务器的注意事项
在迁移服务器时，确保新环境与旧环境的依赖一致非常重要。尤其是涉及到编译的库，如 better-sqlite3，缺少必要的编译工具和依赖可能导致连接失败。建议在迁移前检查新服务器的操作系统和预装依赖，避免类似问题。
Docker 中使用 SQLite 的最佳实践
在 Docker 中使用 SQLite 时，确保在 Dockerfile 中正确安装 sqlite 和 libc6-compat。使用 Volumes 挂载数据库文件时，注意路径的正确性，以避免因路径错误导致的连接问题。
手动构建的必要性
遇到缺少 better_sqlite3.node 文件的情况时，手动构建是解决问题的有效方法。通过在 Dockerfile 中添加构建步骤，可以确保在 CI 环境中成功生成所需的二进制文件，避免因自动构建失败而导致的服务中断。
延伸问答
为什么在迁移服务器时会出现 better-sqlite3 连接 SQLite 的错误？
错误是由于缺少编译好的二进制文件 better_sqlite3.node，导致无法连接数据库。
如何解决 better-sqlite3 找不到绑定文件的问题？
可以通过手动构建 better_sqlite3.node 文件来解决该问题。
在 Docker 中使用 SQLite 时需要注意什么？
需要在 Dockerfile 中安装 libc6-compat 和 sqlite，并确保数据库文件路径正确。
为什么 CI 机器上没有成功执行 node-gyp build？
因为新系统环境缺少一些预装的依赖，导致 node-gyp build 没有执行成功。
选择服务器操作系统时应该考虑哪些因素？
建议优先考虑系统的稳定性，Debian 是一个不错的选择。
better-sqlite3 的安装过程是怎样的？
better-sqlite3 在安装时会尝试自动构建原生模块，如果找不到预编译的二进制文件，则会使用 node-gyp rebuild 进行编译。
