neo4j-go-driver连接失败主因是协议或端口未通，非认证错误；必须用neo4j://或bolt://uri、启用bolt端口7687、显式传auth；参数化查询须用map[string]interface{}绑定动态值，禁字符串拼接；事务需手动commit/rollback，defer tx.close()会导致静默回滚。
neo4j-go-driver 是当前 Go 生态中连接 Neo4j 的事实标准，但直接照抄示例代码常导致连不上、查不到、事务崩掉——问题不在语法，而在协议、认证和生命周期管理的细节上。
连接失败：不是密码错，是协议或端口没通
最常见现象是 context deadline exceeded 或 connection refused，而不是 invalid credentials。这意味着驱动压根没连到服务，而非认证失败。
- URI 必须用
neo4j://localhost:7687或bolt://localhost:7687，http://或https://会被静默忽略 - Docker 启动时必须显式映射
-p 7687:7687，只映射7474（HTTP）不够 - 检查 Neo4j 配置文件
conf/neo4j.conf中是否启用 Bolt：dbms.connector.bolt.enabled=true且dbms.connector.bolt.listen_address=:7687 - 本地开发想跳过 TLS？加配置
neo4j.NoTLS，否则驱动默认尝试加密握手，超时即失败
参数化查询：Cypher 注入风险藏在字符串拼接里
写 "CREATE (:User {name: '" + name + "'})" 看似简单，但一旦 name 是 O'Reilly 或含换行，Cypher 解析就报错；更严重的是，恶意输入可篡改查询逻辑。
- 所有动态值必须用
$key占位符，再通过map[string]interface{}传参，例如：session.Run("MATCH (u) WHERE u.id = $id", map[string]interface{}{"id": 123}) - 节点标签（如
User）、关系类型（如FRIEND_OF）不能参数化，必须白名单校验后拼接，例如：if !isValidLabel(label) { return errors.New("invalid label") } -
time.Time直接传，驱动自动转为 Neo4jDateTime；别传 Unix timestamp 整数，否则存成普通数字属性，后续无法用datetime()函数处理
事务崩溃：不是 panic，是静默回滚
事务内某条语句出错后继续执行下一条，或忘记 tx.Commit()，结果是数据部分写入、部分丢弃，还无报错——这是最隐蔽的数据一致性陷阱。
-
defer tx.Close()看似保险，但tx.Close()在未Commit()时等价于Rollback()，且不返回 error；你得主动判断并处理 - 每条
tx.Run()后必须检查err，出错立即tx.Rollback()并返回，不要“先跑完再说” - 事务对象
neo4j.Transaction不是线程安全的，不能跨 goroutine 复用；一个事务只在一个 goroutine 内完成 - 短命 CLI 工具尤其容易漏掉
driver.Close()，连接池泄漏后系统 socket 耗尽，后续所有请求都卡在acquire connection
嵌套结果解析：Record 不是 struct，Get() 容易 panic
比如 MATCH (a)-[r]->(b) RETURN a, r, b 返回的 neo4j.Record 是扁平 map，字段名是 Cypher 中的别名（如 a、r），不是结构体字段。直接 record.Get("a").(neo4j.Node) 会 panic。
- 用
record.GetAsNode("a")替代record.Get("a").(neo4j.Node)，前者返回(neo4j.Node, error) - 取节点属性用
node.Props()得到map[string]interface{}，再按 key 取值；别假设某个字段一定存在，先if val, ok := props["name"]; ok { ... } - 判断节点类型用
node.Labels()，不是靠属性名（如type字段），因为图模型中标签才是类型标识
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
