如何通过PyScript连接SQL Server？导入pyodbc后页面空白求解决方案

问题原因 #

你遇到的页面空白是因为pyodbc依赖本地系统的ODBC驱动，而PyScript运行在浏览器的WebAssembly(Wasm)环境中，无法访问本地系统的驱动组件，导致导入pyodbc时触发未捕获的错误，页面无法正常渲染。

可行的替代方法 #

方法1：通过后端API中转（推荐） #

浏览器环境下直接连接数据库存在跨域、安全风险，最可靠的方式是通过后端接口中转数据：

步骤1：编写后端接口（以FastAPI为例）

创建后端脚本backend.py，负责连接SQL Server并提供数据接口：

from fastapi import FastAPI
import pyodbc
import pandas as pd
from fastapi.middleware.cors import CORSMiddleware

app = FastAPI()

# 配置跨域允许前端访问
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

@app.get("/get-test-data")
def get_test_data():
    # 替换为你的SQL Server连接信息
    conn_str = "Driver={SQL Server};Server=你的服务器地址;Database=你的数据库名;UID=用户名;PWD=密码;"
    with pyodbc.connect(conn_str) as conn:
        df = pd.read_sql("SELECT * FROM TestTable", conn)
    return df.to_dict(orient="records")

运行后端服务：

uvicorn backend:app --reload

步骤2：前端PyScript调用接口

修改main.py，通过fetch请求后端接口获取数据：

import asyncio
from pyodide.http import fetch

async def load_data():
    try:
        response = await fetch("http://localhost:8000/get-test-data")
        data = await response.json()
        print("获取的数据：", data)
        # 可进一步将数据转为DataFrame处理
        import pandas as pd
        df = pd.DataFrame(data)
        print("转为DataFrame：", df)
    except Exception as e:
        print("请求失败：", str(e))

asyncio.ensure_future(load_data())

方法2：使用纯Python实现的SQL Server驱动（pytds） #

pytds是纯Python编写的SQL Server驱动，不依赖系统ODBC组件，可尝试在PyScript中使用：

修改配置文件pyscript.toml

packages = ["pandas", "pytds"]

修改main.py的连接代码

import pytds
import pandas as pd

try:
    # 替换为你的SQL Server连接信息
    conn = pytds.connect(
        server="你的服务器地址",
        database="你的数据库名",
        user="用户名",
        password="密码"
    )
    cursor = conn.cursor()
    cursor.execute("SELECT * FROM TestTable")
    df = pd.DataFrame((tuple(t) for t in cursor))
    print("查询结果：", df)
    conn.close()
except Exception as e:
    print("连接/查询失败：", str(e))

注意：pytds在Wasm环境下可能存在SSL加密连接的兼容性问题，若你的SQL Server要求SSL连接，可能需要额外配置或测试。

排查页面空白的小技巧 #

打开浏览器开发者工具（按F12），切换到Console面板，查看具体的错误信息，这能帮你快速定位问题所在（比如pyodbc导入失败的报错）。

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