neo4j-go-driver 是 Neo4j 官方维护的 Go SDK，基于 Bolt 协议，需正确配置认证、复用 driver、参数化查询、安全处理嵌套结果、事务失败及时终止并检查 commit 错误，合理设置连接池大小。
用 neo4j-go-driver 连接并执行简单查询
Go 官方不维护 Neo4j 驱动，社区主流选择是 neo4j-go-driver（由 Neo4j 官方团队维护的 Go SDK）。它基于 Bolt 协议，不是 HTTP 封装，所以连接失败时常见原因是 Bolt 端口（默认 7687）未开放或认证失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保 Neo4j 服务已启用 Bolt：检查
neo4j.conf中dbms.connector.bolt.enabled=true和dbms.connector.bolt.listen_address=:7687 - 连接时必须显式传入认证信息，即使本地无密码也要用
neo4j.NoAuth()或neo4j.BasicAuth(...)，空凭证会 panic - 连接对象（
neo4j.DriverWithContext）应复用，不要每次查询都NewDriverWithContext，否则快速耗尽 socket - 示例片段：
driver, err := neo4j.NewDriverWithContext("bolt://localhost:7687", neo4j.BasicAuth("neo4j", "password", ""))
写 Cypher 查询时怎么传参才安全
直接拼接字符串构造 Cypher 是高危操作，不仅易 SQL 注入（Neo4j 虽非 SQL，但参数注入逻辑相同），还会因特殊字符（如单引号、换行）导致语法错误。所有变量必须走参数化查询。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
session.RunWithContext的第二个参数传map[string]interface{}，键名需与 Cypher 中$key严格一致 - 切勿用
fmt.Sprintf拼接节点标签或关系类型——它们不能参数化，只能靠白名单校验后拼接 - 时间类型推荐传
time.Time值，驱动会自动转为 Neo4j 的DateTime；避免传字符串再在 Cypher 里用datetime()解析，性能差且时区易错 - 示例：
result, err := session.RunWithContext(ctx, "MATCH (u:User) WHERE u.age > $minAge RETURN u.name", map[string]interface{}{"minAge": 18})
处理多层嵌套关系查询结果容易崩
Neo4j 返回的图结构数据天然嵌套（比如 MATCH (a)-[r]->(b)-[s]->(c)），但 Go 的 neo4j.Record 是扁平 map，字段名是 Cypher 中的别名，不是结构体字段。直接强转 struct 或反复 .Get() 易 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
record.GetAsXXX("alias")方法（如GetAsString、GetAsNode、GetAsRelationship）代替record.Get("alias").(string)，前者带类型检查和错误返回 - 对
Node类型结果，用node.Props（map[string]interface{}）取属性，不要假设字段存在；用node.Labels判断类型，而非依赖属性名 - 若需深度展开路径（如
p = (a)-[*..3]->(b)），用record.GetAsPath，再调path.Nodes()/path.Relationships()逐层取，别试图一次性解包
事务里写操作失败后状态难恢复
Neo4j 驱动的事务不是“自动回滚”，而是“失败即丢弃”。如果 tx.Run 报错，事务已不可用，但你可能还在用同一个 neo4j.Transaction 变量继续调 Run 或 Commit，这时会 panic 或静默失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 事务必须用
defer tx.Close(ctx)保底清理，哪怕后续Commit成功也建议加（驱动内部有幂等处理） - 写操作务必检查每个
tx.Run的err，出错立即return或break，不要继续执行后续语句 - 需要原子性保障的多步操作，优先用单条 Cypher（如
CREATE ... SET ... RETURN合并在一句），而不是拆成多个tx.Run - 注意
tx.Commit本身也可能失败（如唯一约束冲突），必须检查其返回的err，不能只看前面Run的结果
最常被忽略的是 Bolt 连接池配置：默认 MaxConnectionPoolSize=100，但在高并发短查询场景下，大量 session 创建/关闭会导致连接抖动；实际应根据 QPS 和平均响应时间，用 neo4j.Config{MaxConnectionPoolSize: N} 主动限流。
