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 必须全程一致，即可避免空指针崩溃，顺利启动图数据库服务。
