本文详解如何在 java 应用中正确使用 neo4j java driver 执行 fabric 跨图查询（如 `union` 联合 fabric.graph1 与 fabric.graph2），重点解决 `use fabric` 语法不支持、多图查询报错及连接超时等典型问题。
Neo4j Fabric 是 Neo4j 4.4+ 引入的企业级多图联邦查询能力，允许用户通过统一入口（fabric database）跨多个物理图（如 fabric.graph1、fabric.graph2）执行联合查询（例如 UNION）。但在 Java 驱动中直接复用浏览器中的 :use fabric 或嵌套 USE 语句会失败——因为 Neo4j Java Driver 不支持客户端命令（如 :use），且 Fabric 查询必须在 Fabric 数据库上下文中执行，而非通过 Cypher 中的 USE 子句动态切换。
✅ 正确配置与调用方式
1. 使用 bolt:// 协议（禁用 http://）
浏览器中出现 WebSocket 连接失败（readyState: 3）通常源于误用 HTTP 端点（如 http://localhost:7474）。Fabric 查询仅支持 Bolt 协议。请确保连接 URL 为：
String uri = "bolt://localhost:7687"; // ✅ 正确：Bolt 端口默认 7687 // String uri = "http://localhost:7474"; // ❌ 错误：HTTP 不支持 Fabric 查询
2. 显式指定 Fabric 为默认数据库（关键！）
Java Driver 的 Session 必须在 Fabric 数据库上下文中创建。不能在 Cypher 中 USE fabric，而应在会话初始化时通过 DatabaseConfig 指定：
import org.neo4j.driver.*;
Driver driver = GraphDatabase.driver(uri, AuthTokens.basic("neo4j", "password"));
// ✅ 关键：将默认数据库设为 "fabric"
Session session = driver.session(SessionConfig.forDatabase("fabric"));
// 现在可安全执行 Fabric 联合查询
Result result = session.run(
"USE fabric.graph1 MATCH (n) RETURN n.name AS name, 'graph1' AS source " +
"UNION " +
"USE fabric.graph2 MATCH (n) RETURN n.title AS name, 'graph2' AS source"
);
while (result.hasNext()) {
Record record = result.next();
System.out.printf("Name: %s, Source: %s%n",
record.get("name").asString(),
record.get("source").asString());
}⚠️ 注意事项：SessionConfig.forDatabase("fabric") 是必需的，否则驱动会默认连接至 neo4j 系统数据库，导致 Multiple graphs in the same query not allowed 错误；Fabric 查询中每个子句必须显式 USE ，不可省略；所有参与 UNION 的子查询需返回结构兼容的列名与类型（如上例统一返回 name 和 source）；确保 Neo4j 服务已启用 Fabric 功能（dbms.fabric.enabled=true）并在 neo4j.conf 中正确定义了 fabric 图映射。
总结
Fabric 跨图查询在 Java 中的成功执行依赖两个硬性前提：协议必须为 Bolt，会话必须绑定到 fabric 数据库。摒弃在 Cypher 中尝试 USE 切换的思路，转而通过驱动层配置确立上下文，是适配 Fabric 架构的关键范式。完成配置后，即可像在 Browser 中一样，编写清晰、可维护的多图联合查询逻辑。
立即学习“Java免费学习笔记（深入）”；
