
cayley 默认不支持直接以 `--db="bolt"` 启动,必须先通过 `cayley init` 初始化 boltdb 文件,并显式指定 `--dbpath`,否则会因未创建底层数据库文件而触发空指针 panic。
在 Cayley 中使用 BoltDB 作为后端存储时,不能跳过初始化步骤直接运行 HTTP 服务。BoltDB 是一个基于单文件的嵌入式键值数据库,它要求目标数据库文件(.db)在首次访问前已存在且结构已初始化。而 cayley http --db="bolt" 命令会尝试直接打开一个尚未创建或未初始化的 BoltDB 文件,导致底层 bucket.Get() 调用时访问空 bucket 指针,最终引发 invalid memory address or nil pointer dereference panic(如错误堆栈所示)。
✅ 正确流程如下:
-
确保 BoltDB 依赖已安装(Cayley v0.7.x 及更早版本需手动安装;v0.8+ 已将 BoltDB 移至 go.mod,通常无需额外操作,但若构建失败仍可显式拉取):
go get github.com/boltdb/bolt/...
-
初始化 BoltDB 数据库文件(关键步骤!):
cayley init --db=bolt --dbpath=/tmp/cayley.bolt
此命令会创建 /tmp/cayley.bolt 文件,并完成必要的元数据表(如 metadata bucket)初始化,为后续读写做好准备。
-
启动 Cayley HTTP 服务并指定同一数据库路径:
cayley http --db=bolt --dbpath=/tmp/cayley.bolt
⚠️ 注意:--dbpath 必须与 init 时完全一致,且不可省略 —— 即使路径是默认值(如 ./cayley.bolt),也必须显式传入。
? 补充说明:
- BoltDB 不支持多进程并发写入,因此仅适用于单机开发、测试或轻量级部署场景;
- 若需生产级高可用与并发能力,建议切换至 LevelDB(内置)、Badger 或分布式后端(如 MongoDB、Elasticsearch);
- 初始化后,可通过 cayley load 导入 .nq 或 .jsonld 格式的三元组数据;
- 日志中若出现 no such file or directory 错误,通常意味着 --dbpath 指向的目录不存在,请提前创建父目录(如 mkdir -p /tmp/cayley)。
总结:BoltDB 在 Cayley 中不是“即插即用”型后端,其强依赖显式初始化。牢记 init → http 两步缺一不可,且 --dbpath 必须全程一致,即可避免空指针崩溃,顺利启动图数据库服务。








