MacOS下Python用jaydebeapi连接SQL Server找不到SQLServerDriver类怎么办

路径修正 #

你代码中的JDBC驱动路径写的是相对路径，系统无法正确定位jar包，需要改为根目录开头的绝对路径：

# 路径开头加/指向系统根目录
jdbc_driver_path = os.path.join('/', 'Library', 'Java', 'Extensions', 'sqljdbc_9.4', 'enu', 'mssql-jdbc-9.4.0.jre16.jar')

修改后先执行print(os.path.exists(jdbc_driver_path))验证路径有效性，返回True再进行后续操作。

版本匹配校验 #

你当前使用的是jre16版本的JDBC驱动，仅兼容Java 16及以上版本，先执行终端命令java -version查看本地Java版本：

• 若Java版本为8，更换jre8版本的mssql-jdbc驱动
• 若Java版本为11，更换jre11版本的mssql-jdbc驱动
• 仅Java版本≥16时可继续使用当前的jre16版本驱动

代码逻辑调整 #

修正JDBC连接URL格式 #

jaydebeapi第二个入参需要是完整的JDBC连接串，不能直接填写主机地址，正确格式为：
jdbc:sqlserver://<主机地址>:<端口号>;databaseName=<数据库名称>
SQL Server默认端口为1433，未修改可直接填写。

手动控制JVM启动 #

自动启动JVM容易出现类路径识别问题，改为提前手动启动，且确保JVM仅启动一次（多进程场景下每个进程单独启动，不要跨进程传递JVM实例），修改后完整代码如下：

import jaydebeapi
import jpype
import os

class MyClass:
    jdbc_driver_path = os.path.join('/', 'Library', 'Java', 'Extensions', 'sqljdbc_9.4', 'enu', 'mssql-jdbc-9.4.0.jre16.jar')
    # 替换为实际的连接地址、端口、库名
    jdbc_url = "jdbc:sqlserver://127.0.0.1:1433;databaseName=your_database"
    jaydebeapi_args = [
        'com.microsoft.sqlserver.jdbc.SQLServerDriver',
        jdbc_url,
        dict(user='<your_username>', password='<your_password>'),
        jdbc_driver_path
    ]

    def __init__(self):
        # 先判断JVM是否已启动，避免重复启动报错
        if not jpype.isJVMStarted():
            jpype.startJVM(classpath=[self.jdbc_driver_path])
        self.connection = jaydebeapi.connect(*self.jaydebeapi_args)

多余配置清理 #

你之前设置CLASSPATH的命令存在语法错误（export后加$是错误写法），且手动指定JVM类路径后无需依赖系统CLASSPATH配置，可删除相关环境变量配置，避免干扰。

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