Neo4j在Go中关联查询的关键是安全稳定落地多跳路径、嵌套结构和动态条件：必须用map[string]interface{}参数化查询，正确解析neo4j.Path、Node等类型，显式处理事务Commit/Rollback，调优连接池，并确保Bolt协议端口7687连通。
Neo4j 的关联查询在 Go 中不是“写完 Cypher 就完事”，关键在于如何用 neo4j-go-driver 安全、稳定地把多跳路径、嵌套结构、动态条件落地——稍有不慎，panic、空指针、连接卡死、时区错乱全会冒出来。
连接失败时别急着改密码，先确认 Bolt 协议和端口
绝大多数“连不上”根本不是认证问题，而是协议或网络层没通。驱动只认 bolt:// 或 neo4j://，不支持 http://；默认监听端口是 7687，不是浏览器用的 7474。
- 用
telnet localhost 7687或nc -zv localhost 7687直接测端口是否可达 - 检查
neo4j.conf是否启用 Bolt：dbms.connector.bolt.enabled=true，且监听地址未绑定到127.0.0.1（远程连接需设为0.0.0.0） - URI 必须写成
"neo4j://localhost:7687"，不能把用户名密码拼进去（如"neo4j://neo4j:pwd@localhost:7687"），驱动会忽略 - 本地开发想跳过 TLS？加配置
neo4j.NoTLS()，否则neo4j://默认尝试加密握手，失败就 timeout
多跳路径查询返回 neo4j.Path，别当 map 强转
像 MATCH p=(a)-[r*1..3]->(b) RETURN p 这类查询，结果不是 JSON 或 map，而是 neo4j.Path 类型。直接 record.Get("p").(map[string]interface{}) 必 panic。
- 正确做法：先
v, ok := record.Get("p")，再判断v是否为neo4j.Path，然后调用p.Nodes()和p.Relationships()拆解 - 节点属性必须用
node.Props()获取，返回map[string]interface{}；别假设字段存在，用props["name"]前先if name, ok := props["name"]; ok - 如果只想取路径起点/终点节点，用
p.StartNode()/p.EndNode()，比遍历Nodes()更高效 - 可变长关系
[r*1..3]在大数据量图上极易慢，务必加LIMIT 100，否则一次查询可能拖垮整个库
事务里写多条语句，出错不 rollback 就等于数据污染
neo4j-go-driver 的事务不会自动回滚。哪怕 tx.Run() 返回 error，只要没显式 tx.Rollback() 或 tx.Close()，事务就还挂着，连接池里的 session 会被锁死。
立即学习“go语言免费学习笔记（深入）”；
- 绝对不要写
defer tx.Close()—— 它在未 commit 时等价于 rollback，但不返回 error，你根本不知道失败了 - 每条
tx.Run()后必须检查 err：如果出错，立刻tx.Rollback()并 return，不能再往下执行 - commit 也必须检查 error：
err := tx.Commit(ctx)，失败说明写入没生效，得重试或告警 - 事务超时要靠
context.WithTimeout控制，避免长事务阻塞连接池
参数化查询不是可选项，是唯一安全路径
所有用户输入、动态值、时间、列表，都必须走 map[string]interface{} 参数绑定。字符串拼接 Cypher 不仅危险，还会让 Neo4j 无法复用查询计划，性能掉一截。
- 节点标签、关系类型不能参数化，只能白名单校验后拼接：
if label == "User" || label == "Article" { cypher = "MATCH (n:" + label + ")..." } - 时间统一传
time.Time，驱动自动转DateTime；别传字符串或 Unix timestamp，后者存成数字属性，查起来没法用date()函数 - IN 查询直接传 slice：
map[string]interface{}{"ids": []string{"u1", "u2"}}，Cypher 写WHERE u.id IN $ids，驱动原生支持 - 空 map 不能传
nil，哪怕没参数也要传map[string]interface{}，否则session.Run()panic
最常被跳过的其实是连接池配置——默认 MaxConnectionPoolSize=100 看似够用，但在高并发短请求场景下，连接建立开销远大于复用成本；而 MaxConnectionLifetime 设太长，又会导致 stale connection 积累。这些细节不调，跑几天就发现请求开始随机 timeout。
