Beego 需手动集成 Neo4j 官方 Go 驱动，启动时单例初始化 driver 并注入全局；URI 必须为 neo4j:// 或 neo4j+s://，认证密码不可为空；driver.Close() 应在应用退出时调用；Controller 中需用参数化 Cypher、每次新建 session 并及时关闭；写操作必须显式事务；禁用驱动 ConsoleLogger，统一由 beego 日志管理；慢查询与连接池超时需针对性监控和调优。
Beego 本身不提供 Neo4j 原生支持，必须手动集成官方 Go 驱动 github.com/neo4j/neo4j-go-driver/v5；直接用 beego 的 orm.RegisterDriver 或内置 ORM 模块无法操作 Neo4j。
beego 启动时初始化 Neo4j 驱动实例
不能把驱动创建逻辑写在控制器里或每次请求都新建，否则连接池失控、资源泄漏。应在 beego 应用启动阶段（main.go 或 app.conf 加载后）完成单例初始化，并注入全局可访问对象（如 models.Neo4jDriver）。
- 使用
neo4j.NewDriverWithContext创建驱动，URI 格式必须为neo4j://或neo4j+s://，不是 HTTP 地址（http://localhost:7474是浏览器端口，非 Bolt 协议） - 认证参数中密码不能为空字符串；若用默认
neo4j/password，需确保 Neo4j 服务已改密或首次启动时完成密码重置，否则VerifyConnectivity会返回Neo4jError: Invalid username or password - 务必调用
defer driver.Close(ctx)—— 但注意：这个Close必须放在应用退出前（如os.Interrupt信号处理中），不能放在 HTTP handler 内，否则每次请求都关掉连接池
在 beego Controller 中安全执行 Cypher 查询
beego 的 Controller 是短生命周期对象，不能持有 driver 实例，所有数据库操作必须通过传入的 context.Context 和预先准备好的 driver 执行会话（neo4j.SessionWithContext）。
- 每次查询前新建 session，用完立即
Close()：session 不是线程安全的，不可复用或跨 goroutine 共享 - 避免裸写 Cypher 字符串拼接，尤其涉及用户输入时——必须用参数化查询，例如：
"MATCH (p:Person) WHERE p.name = $name RETURN p"，然后传入map[string]interface{}{"name": userName} - 对写操作（
CREATE/MERGE）必须显式开启事务：session.NewTransactionWithContext(ctx)，并在成功后Commit()，失败时Rollback()；忽略事务会导致部分写入丢失且无报错
beego 日志与 Neo4j 驱动日志共存问题
beego 默认用 logs.BeeLogger，而 Neo4j 驱动的 ConsoleLogger 会直接写 os.Stderr，两者日志格式、级别、输出目标不一致，线上排查时容易混乱。
- 禁用驱动控制台日志：
neo4j.Config{Log: neo4j.NoOpLogger{}}，改由 beego 统一收集关键事件（如连接失败、查询超时） - 对慢查询做拦截：在执行
Run前记录开始时间，结束后若耗时 >500ms，用beego.Warn记录 Cypher 片段（注意脱敏，不打参数值） - 连接池满导致的
connection acquisition timeout错误，在 beego 日志中表现为context deadline exceeded，需结合MaxConnectionPoolSize和并发量调整，而非简单重试
真正难的不是连上 Neo4j，而是让 beego 的请求生命周期、错误传播链、日志上下文和 Neo4j 的 session/transaction/timeout 模型对齐——漏掉任意一环，都会在高并发下出现静默失败或连接堆积。
