Neo4j Go驱动不内置图算法，需调用服务端GDS插件执行；参数须用map传入、结果中nodeId需用gds.util.asNode()转换，且须正确配置GDS内存与超时。
Neo4j 官方驱动不带图算法，别白找 graphAlgo 函数
Go 语言没有官方维护的 Neo4j 图算法库。Neo4j 自己的 neo4j-go-driver 只负责发 Cypher 查询、收结果，不封装 PageRank、Louvain、ShortestPath 等算法逻辑——那些都得靠 Neo4j Server 端的 apoc 或 gds（Graph Data Science）插件来跑。
常见错误现象：cannot find package "github.com/neo4j/neo4j-go-driver/graphAlgo" 或翻遍文档找不到 driver.Session().RunAlgo() 这种方法。
- 所有图算法必须以 Cypher 形式发给服务端，比如
CALL gds.pageRank.stream(...) - 确保 Neo4j 实例已安装并启用
gds插件（社区版默认不带，需用 Enterprise 版或手动安装 GDS Lite） - Go 侧只做参数拼接、结果解析，不参与算法计算
用 Go 调用 GDS 算法时，Cypher 参数必须显式传 Map，不能硬编码字符串
GDS 的过程调用（如 gds.alpha.modularityOptimization）依赖运行时参数，比如节点过滤条件、关系类型、迭代次数。直接拼字符串易出错，且无法复用、难测试。
正确做法是把参数组织成 map[string]interface{}，再传给 session.Run() 的第二个参数：
立即学习“go语言免费学习笔记（深入）”；
params := map[string]interface{}{
"nodeProjection": "User",
"relationshipProjection": "FRIENDS",
"maxIterations": 10,
}
result, err := session.Run(
"CALL gds.louvain.stream($config) YIELD nodeId, communityId RETURN gds.util.asNode(nodeId).name AS name, communityId",
params,
)
- 参数名必须和 GDS 文档中
config字段完全一致（大小写敏感），例如nodeProjection不是node_projection - 字符串值要加引号（
"User"），数字不用（10），布尔值用 Go 的true/false，GDS 会自动转 - 如果漏传必填参数（如
nodeProjection），报错通常是Failed to invoke procedure `gds.louvain.stream`: Caused by: java.lang.IllegalArgumentException: Missing required configuration parameter: nodeProjection
从 GDS 结果里取 nodeId 别直接用 record.Get("nodeId")
GDS 返回的 nodeId 是内部 ID（long 类型），不是你业务里的 id 属性。直接取它再查节点，大概率查不到，或者查错实体。
真正安全的做法：在 Cypher 里就用 gds.util.asNode() 或提前 MATCH 出业务字段：
<pre class="brush:php;toolbar:false;">CALL gds.pageRank.stream($config) YIELD nodeId, score RETURN gds.util.asNode(nodeId).uuid AS uuid, score
gds.util.asNode(nodeId) 是 GDS 提供的安全转换函数，比自己写 <code>MATCH (n) WHERE id(n) = $nodeId RETURN n.uuid更快、更可靠- 若节点没对应属性（比如
uuid为空），asNode()返回null，Go 侧收到的是nil，需要判空，否则record.Get("uuid").(string)panic - 不要依赖
id(n)做业务关联——它随数据库重建可能变，而你的业务主键（如user_id）才是唯一锚点
GDS 内存配置不对，Go 程序会卡住或报 OutOfMemoryError
GDS 算法（尤其是 Louvain、Label Propagation）默认申请大量内存。Neo4j 启动时没调大堆内存或 GDS heap 配置，Go 客户端发请求后就会 hang 住，或返回 500 错误：
Failed to invoke procedure `gds.louvain.stream`: Caused by: java.lang.OutOfMemoryError: Java heap space
- 检查
neo4j.conf是否设了dbms.memory.heap.initial_size=4g和dbms.memory.heap.max_size=4g - 必须显式配置 GDS heap：
gds.memory.projection.maximum=2g（建议设为 heap 的 40%~50%） - Go 侧加超时控制：
session := driver.NewSession(neo4j.SessionConfig{AccessMode: neo4j.AccessModeRead, DatabaseName: "neo4j", ImpersonatedUser: "", Bookmarks: nil, FetchSize: 0, DefaultTimeout: 60 * time.Second})
复杂点在于：GDS 的内存限制是全局的，不是 per-query；多个并发算法请求可能互相挤占，得靠限流或错峰执行来兜底。
