如何在PyScript中使用Neo4j？导入后网页加载失败求助

核心原因 #

PyScript基于Pyodide运行Python代码，而neo4j官方Python驱动依赖部分底层系统库（如加密模块、socket扩展），这些模块在Pyodide的WebAssembly环境中存在兼容性缺失，导致加载卡住或失败。

分步解决尝试 #

1. 启用调试模式定位具体错误 #

在PyScript配置中开启终端输出，查看浏览器控制台的加载日志，明确是依赖缺失还是编译错误：

<py-config>
  packages = ["neo4j"]
  terminal = true
</py-config>

打开浏览器开发者工具（F12）的Console标签，可看到详细的加载报错信息，比如缺失cryptography等依赖。

2. 指定兼容的neo4j版本 #

尝试使用纯Python实现占比更高的旧版本，比如4.4.x系列（5.x版本引入了更多C扩展优化）：

<py-config>
  packages = ["neo4j==4.4.11"]
</py-config>

部分旧版本的neo4j驱动对Pyodide兼容性更好。

3. 改用JS驱动+PyScript互调（最可靠方案） #

如果Python驱动始终无法加载，可直接使用官方JavaScript驱动，通过PyScript的JS互调功能实现逻辑，既保留Python代码结构，又规避兼容性问题：

1. 先引入JS驱动：

<script src="https://cdn.jsdelivr.net/npm/neo4j-driver"></script>

2. 在PyScript中调用JS驱动：

from js import neo4j
import asyncio

# 初始化驱动
driver = neo4j.driver(
    "bolt://your-neo4j-host:7687",
    neo4j.auth.basic("your-username", "your-password")
)

async def run_cypher_query():
    try:
        session = driver.session()
        # 执行Cypher查询
        result = await session.run("MATCH (n) RETURN n.name LIMIT 5")
        # 转换结果
        records = await result.toArray()
        for record in records:
            print(f"节点名称: {record.get('n.name')}")
    finally:
        await session.close()
        await driver.close()

# 启动异步任务
asyncio.ensure_future(run_cypher_query())

4. 解决跨域问题 #

即使驱动加载成功，客户端连接Neo4j时可能触发CORS错误，需在Neo4j服务器配置中添加允许的网页域名：

• 编辑Neo4j配置文件neo4j.conf，添加：

  dbms.security.http_auth_allowlist=*
  dbms.security.cors.enabled=true
  dbms.security.cors.allow_origin=http://your-web-domain.com
  

• 如果使用Neo4j Aura云服务，在控制台的"Connection settings"中添加网页域名到允许列表。

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