neo4j 官方不提供 go orm 或 dsl，唯一推荐 neo4j-go-driver，所有查询须手写 cypher + 参数绑定；禁止字符串拼接防注入，标识符需白名单校验，返回值须按类型分支处理，事务须显式回滚，连接池需调优。
Neo4j 官方不提供 Go 的 ORM 或查询构建框架，neo4j-go-driver 是唯一推荐的底层 SDK，所有关系建模和查询都得靠手写 Cypher + 参数绑定完成 —— 试图用“框架”抽象图结构反而会掩盖路径语义、拖慢性能、增加调试成本。
为什么不能依赖 ORM 或 DSL 框架
图查询的核心是模式匹配（MATCH）和路径遍历（-[r*1..5]->），而 ORM 天然面向表格扁平结构。常见“Go Neo4j ORM”类库要么封装极薄（本质还是拼 Cypher），要么强行映射节点为 struct 导致：
- 可变长关系
r*1..3无法静态声明字段 - 路径（
Path）类型在 Go 中没有对应 struct，强转必 panic - 多跳聚合（如
count((u)-[:FRIEND]->(:User)-[:WORKS_AT]->(:Company))）无法用链式调用表达 - 索引提示（
USING INDEX）、计划优化（EXPLAIN）等关键能力被屏蔽
session.Run() 是唯一可靠入口，参数必须用 map[string]interface{}
所有动态值（用户 ID、时间范围、标签白名单）只能通过命名参数传入，绝不可字符串拼接：
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 错误示例：
"MATCH (u:User) WHERE u.id = '" + userID + "'"→ 注入风险 + 单引号崩溃 - 正确写法：
session.Run(ctx, "MATCH (u:User) WHERE u.id = $id", map[string]interface{}{"id": userID}) - 复杂值直接传：slice 自动转 Neo4j List，
time.Time自动转DateTime，struct 自动转 Map - 标识符（label、rel-type、变量名）不能参数化，需白名单校验后拼接：
fmt.Sprintf("MATCH (n:%s)", sanitizeLabel(label))
处理返回的 neo4j.Record 必须按类型分支取值
Neo4j 返回的不是 JSON，而是带类型的二进制流，record.Get("name") 可能返回 string、int64、neo4j.Node、neo4j.Path 等不同底层类型：
- 查单个节点：
node := record.GetAsNode("n"); props := node.Props（别用.Get("n").(neo4j.Node)） - 查路径：
p := record.GetAsPath("p"); nodes := p.Nodes(); rels := p.Relationships() - 查匿名映射：
RETURN {name: u.name, score: u.score}→ 得到map[string]interface{}，可用record.GetAsMap("data") - 永远先调
records.Next(ctx)，再检查records.Err()，否则错失网络中断等底层错误
事务失败后不 Rollback() 会导致连接池卡死
neo4j.Transaction 不是自动管理的，tx.Close() ≠ tx.Rollback()，出错后若不显式回滚，该事务占用的连接会一直挂起：
- 正确模式：
tx, _ := session.BeginTransaction(); defer tx.Close()+ 每个 error 分支里手动tx.Rollback() - 更稳妥写法：
session.WriteTransaction()封装函数，它会在 panic 或 error 时自动 rollback - 读写混合事务中，避免在
tx.Run()后再调session.Run()—— session 和 tx 生命周期不重叠 - 连接池参数必须调优：
MaxConnectionPoolSize建议设为并发请求数 × 2，MaxConnectionLifetime设为 30–60 分钟防 stale 连接
最易被忽略的是：Cypher 中的 id(n) 是内部 ID，重启或迁移后失效；生产环境所有关系查询必须基于业务主键（uuid、slug），且为这些字段建唯一约束和索引，否则 MATCH 会全表扫描。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
