用 neo4j-go-driver 执行 cypher 查询最简路径是：初始化驱动用 neo4j.newdriverwithcontext，创建 session 后 defer session.close(ctx)，调用 session.run(ctx, cypher, params) 传 map[string]interface{} 参数，再通过 records.next(ctx) 迭代并检查 records.err()，用 record.get("key") 安全取值并做类型断言。
用 neo4j-go-driver 执行 Cypher 查询最简路径
Go 操作 Neo4j 的事实标准是官方维护的 neo4j-go-driver，不是第三方封装库。它不提供 ORM 或 DSL，所有查询都走原始 Cypher 字符串 + 参数绑定 —— 这既是灵活性来源，也是出错高发区。
实操建议：
- 初始化驱动时必须用
neo4j.NewDriverWithContext，传入 context（别用已弃用的NewDriver） - Session 一定要显式关闭：
defer session.Close(ctx)，否则连接泄漏比想象中快 - Cypher 查询统一走
session.Run(ctx, cypher, params)，params必须是map[string]interface{}，键名要和 Cypher 中的$param完全一致
示例：查某个用户的所有好友名
cypher := `MATCH (u:User {id: $userId})-[:FRIEND]->(f:User) RETURN f.name`
records, err := session.Run(ctx, cypher, map[string]interface{}{"userId": "u123"})
处理 Cypher 返回结果时最容易 panic 的地方
session.Run 返回的是 neo4j.Result，它不自动解析结果，也不校验字段是否存在 —— 你得自己迭代、取值、类型断言。常见错误是直接调 record.Get("name") 而没检查 err 或 record 是否为空。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 每次
records.Next(ctx)后，必须立刻检查records.Err()，不能只看循环是否结束 - 取字段前先用
record.Values()看长度，或用record.GetByIndex(0)/record.Get("name")，但后者在字段名拼错时返回nil，不报错 - 值类型不是 Go 原生类型：字符串是
string，数字可能是int64或float64，时间是time.Time，但map和list会变成map[string]interface{}和[]interface{}，需手动转换
别写这样的代码：name := record.Get("name").(string) —— 类型断言失败直接 panic。
写入数据时事务控制与错误恢复怎么做
Neo4j 的写操作必须在事务内完成，session.WriteTransaction 是唯一安全方式。手写 BeginTransaction + Commit 容易漏掉 Rollback，尤其在 error 分支里。
实操建议：
- 所有写操作封装进函数传给
session.WriteTransaction(ctx, fn)，驱动会自动重试（最多一次）网络闪断类错误 - 事务函数内不要做耗时 I/O 或 sleep，否则拖慢整个事务超时（默认 30s）
- 如果需要多语句原子性（比如先删后增），必须塞进同一个事务；跨事务的“逻辑一致性”得靠应用层补偿，驱动不帮你
- 错误类型要区分：
neo4j.TransientError可重试，neo4j.DatabaseError一般是 Cypher 写错或约束冲突，重试没用
例如创建带唯一约束的节点失败时，错误信息是 Neo.ClientError.Schema.ConstraintValidationFailed，不是网络问题。
连接池配置不当导致本地跑得通、上线就超时
默认连接池最大连接数是 100，看似够用，但在高并发短连接场景（比如 HTTP handler 每次新建 session）下，可能因连接建立/销毁开销大，反而比小连接池更慢。更常见的是没设连接空闲超时，连接长期占用却不干活。
实操建议：
- 初始化驱动时传
neo4j.WithMaxConnectionPoolSize(50)，根据 QPS 和平均响应时间调 —— 公式粗略为并发数 ≈ QPS × 平均延迟(s) - 务必加
neo4j.WithConnectionAcquisitionTimeout(3 * time.Second)，避免某次卡死拖垮整个服务 - 开发环境可以开
neo4j.WithLogger(neo4j.ConsoleLogger{})，但上线必须关，日志量极大 - Neo4j 5.x 默认启用 Bolt v4 协议，老版本驱动（v1.x）不兼容，会报
unknown message: 0x6b这类底层错误
连接池参数改完不测压，等于没改。真实瓶颈往往不在 Cypher，而在 acquire connection 这一步。
