使用Neo4j.Driver连接Memgraph时出现Session空引用异常

核心问题分析 #

你的代码触发NullReferenceException主要有几个关键原因，结合Memgraph Docker部署场景逐一梳理：

1. async void方法的不合理使用 #

async void仅适用于事件处理程序，普通异步方法使用它会导致：

• 异常无法被上层调用者捕获
• 异步操作未完成时程序可能提前终止，引发对象意外释放，进而触发空引用

2. Docker端口映射未配置 #

如果启动Memgraph容器时未将7687端口绑定到主机，主机无法访问容器内服务，可能导致驱动初始化异常，间接引发空引用。

3. 驱动与Memgraph版本不兼容 #

Memgraph兼容Neo4j的Bolt协议，但驱动版本过高或过低会导致通信异常，进而出现空引用问题。

修正后的代码 #

public async Task DatabaseConnectionTest()
{
    // 使用using自动释放资源，避免手动Dispose遗漏
    using IDriver driver = GraphDatabase.Driver("bolt://127.0.0.1:7687", AuthTokens.None);
    
    // 提前验证连接状态，避免后续操作失败
    try
    {
        await driver.VerifyConnectivityAsync();
    }
    catch (Exception connEx)
    {
        Console.WriteLine($"连接验证失败: {connEx.Message}");
        return;
    }

    using IAsyncSession session = driver.AsyncSession();
    try
    {
        // 注意标签语法：(n:TestNode) 而非 (n: TestNode)（标签和冒号间无空格）
        IResultCursor cursor = await session.RunAsync("CREATE (n:TestNode) RETURN n");
        await cursor.ConsumeAsync();
        Console.WriteLine("节点创建成功");
    }
    catch (Exception e)
    {
        Console.WriteLine($"异常信息: {e.Message}");
        Console.WriteLine($"详细堆栈: {e.StackTrace}");
    }
}

排查步骤 #

• 确认Docker端口映射：启动容器时必须添加-p 7687:7687参数，示例启动命令：

  docker run -p 7687:7687 memgraph/memgraph
  

  用docker ps查看容器端口绑定，确保0.0.0.0:7687->7687/tcp存在。

• 替换async void为async Task：调用该方法时需用await DatabaseConnectionTest();，确保异步操作完整执行。

• 检查驱动版本：Memgraph 2.x及以上版本推荐使用Neo4j .NET驱动4.4.x或5.x版本，避免版本不匹配导致通信问题。

• 查看完整异常堆栈：在catch块中打印堆栈跟踪，精准定位空引用来源（比如session是否为null，或是RunAsync内部逻辑问题）。

内容的提问来源于stack exchange，提问作者zackper