近日重新把尘封已久的树莓派翻了出来，准备用于公司内部的前端服务层（Backends For Frontends，即BFF）。由于之前已经有了不少使用树莓派的经验，这次也是信心满满地刻录Raspbian进去，带到公司后开启SSH就拿出来用了。

本来一路顺利，node环境的搭建也基本正常，结果在安装sqlite3的时候报错。

如果只是一般的安装配置错误，应该能够简单地解决，但这次却踩了一些坑，所以在这里做个记录。

首先，sqlite3没有针对树莓派的预编译版本，只能在本地编译，需要使用build from source，这一点官方文档有指出，并且专门说明了针对树莓派的情况（including Raspberry Pi）。

1
2
3
4

export LDFLAGS="-L/usr/local/lib"
export CPPFLAGS="-I/usr/local/include -I/usr/local/include/sqlcipher"
export CXXFLAGS="$CPPFLAGS"
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/local --verbose

以上前三行命令的作用是设置linux系统的配置项。第四行里使用了npm的参数–build-from-source，即通过编译来安装。

但如果仅仅只是这样就能解决问题，事情倒好办了。官方文档的这个命令是有坑的：通过该命令安装时会报编译错误。应该会提示类似：

1

No rule to make target '../.node-gyp/10.15.1/include/node/common.gypi', needed by 'Makefile'

这个问题涉及到npm的权限，出于某种安全原因，npm似乎不能直接在root权限下进行编译安装，在root下就会报以上错误，但如果不使用root又会报权限不足的错误，因此到这里似乎走进了死胡同。

不过npm其实并非完全不允许在root下进行编译安装，解决方法是添加参数unsafe perm。关于这一问题可以参考这个issue，所以实际应当使用的命令为：

1

npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/local --verbose --unsafe-perm

关于unsafe perm的参数可以参考这个文档。

经过了以上步骤就可以继续安装sqlite3了吗？

然而并不行，再次运行安装命令的时候会提示一个错误：

1

fatal error: sqlite3.h

从错误信息来看应该是缺少sqlite3的头文件，因此我们需要先通过系统的包管理器安装libsqlite3-dev，即

1

apt-get install libsqlite3-dev

还没完，在装好libsqlite3-dev之后，还会提示缺少sqlcipher的开发库，我对sqlcipher知之甚少，搜索之后发现问题与上面类似，可以参考StackOverflow的这个帖子，需要安装libsqlcipher-dev：

1

apt-get install libsqlcipher-dev

到此，在树莓派的npm中编译安装sqlite3的全部准备工作才真正完成，这个时候再运行一次：

1

npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/local --verbose --unsafe-perm

即可成功安装sqlite3，在node使用也一切正常。

希望可以帮到后来人。