最常见原因是驱动版本与neo4j服务版本不兼容或未启用bolt协议；neo4j 4.0+仅支持bolt://（7687端口），需用官方neo4j-go-driver、启用认证、指定数据库名、参数化查询、手动处理null/关系节点、显式事务回滚及合理配置连接池与超时。
用 neo4j-go-driver 连接 neo4j 时为什么连不上？
最常见原因是驱动版本与 neo4j 服务版本不兼容，或未启用 bolt 协议。neo4j 4.0+ 默认只开 bolt://（端口 7687），关闭了旧的 http:// 接口；而早期 go 驱动（如 neoism）只支持 http，已无法使用。
必须用官方维护的 neo4j-go-driver（GitHub 上 neo4j-drivers/go），它只支持 Bolt，且要求 Neo4j 服务开启认证（即使本地开发也需设密码，不能留空）。
- 检查 Neo4j 是否运行：
curl -I http://localhost:7474（HTTP 管理界面）和telnet localhost 7687（Bolt 端口）都通才可能连上 - 连接字符串格式必须是
neo4j://localhost:7687，不是http://或bolt://（bolt://已被弃用，新版驱动会报unknown scheme） - 初始化 session 时要显式指定数据库名（Neo4j 4.4+ 强制要求），比如
database: "neo4j"，否则会报Invalid database name
执行 Cypher 查询时如何安全传参避免注入？
Go 驱动不支持字符串拼接 Cypher，所有动态值必须走参数绑定——这是唯一防注入的方式，也是官方强制要求。
参数以 map[string]interface{} 形式传入 session.Run() 第二个参数，键名需与 Cypher 中 $key 完全一致，类型需匹配（如 int64 对应 Cypher 的 integer，string 对应 string）。
- 错误写法：
"CREATE (:User {name: '" + name + "'})"—— 直接 panic 或被拒绝执行 - 正确写法：
session.Run("CREATE (:User {name: $name})", map[string]interface{}{"name": name}) - 数组参数可用
[]string，Cypher 中用$tags，匹配IN $tags；时间类型推荐用time.Time，驱动自动转为 Neo4j 的DateTime
读取查询结果时怎么处理 NULL 和关系节点？
Neo4j 返回的字段可能是 nil（对应 Cypher 中的 null），也可能是结构化数据（如 Node、Relationship、Path）。驱动不会自动解包，必须手动调用 Record.Get() 并做类型断言。
尤其注意：Node.Props() 返回 map[string]interface{}，但其中值仍是 driver 内部类型（如 neo4j.Node、neo4j.Date），不能直接 JSON 序列化；需先转成 Go 原生类型。
- 安全取字段：
if v, ok := record.Get("user"); ok && v != nil { node, _ := v.(neo4j.Node) } - 处理 NULL：
if v, ok := record.Get("email"); ok && v != nil { email = v.(string) }，否则 email 保持零值 - 关系节点要单独 fetch：
rel, _ := v.(neo4j.Relationship)，其Props()同样返回 map，但StartNodeID()/EndNodeID()是int64，不是 Node 实例
事务里写入失败后如何确保回滚？
Go 驱动不提供隐式事务管理，必须显式调用 tx.Close() 或 tx.Rollback()，否则连接会卡住、连接池耗尽。
标准模式是用 defer tx.Close() 开头，再在逻辑分支中判断是否 tx.Commit()；一旦中间出错（如 tx.Run() 返回 error），就直接 return，让 defer 触发 rollback。
- 别在 defer 里 commit：
defer tx.Commit()是错的，会导致成功/失败都 commit - 错误捕获要覆盖所有
tx.Run()调用，哪怕只有一处没 check，就可能漏掉 error 导致误提交 - 超时控制建议设在 session 层：
session.WithTransactionConfig(neo4j.TransactionConfig{Timeout: 30 * time.Second})，避免长事务阻塞
Neo4j 的 Go 驱动对类型转换很严格，尤其是时间、整数、NULL 这三类，稍不注意就会 panic；另外 Bolt 连接池默认大小是 100，高并发下容易打满，需要根据实际负载调 neo4j.Config{MaxConnectionPoolSize: 200}。
