连接SQL Server的Python脚本在IDLE运行正常但命令行执行失败如何解决

第一步：先捕获具体报错信息 #

首先修改代码，给数据库连接逻辑增加异常捕获，定位具体失败原因：

import pyodbc
import traceback

print ("hello")
try:
    conn = pyodbc.connect('Driver={SQL Server};'
                        'Server=testserver;'
                        'Database=database_test;'
                        'Trusted_Connection=yes;')
    cursor = conn.cursor()
    print ('{SQL Server}')
    print ("hello2")
except Exception as e:
    print("连接失败，错误信息：", e)
    traceback.print_exc()

修改后再在命令行运行，就能看到具体的失败原因，再对应处理。

常见原因及解决方法 #

• 运行身份权限不匹配
  你代码里用了Trusted_Connection=yes也就是Windows集成身份验证，IDLE默认是当前登录用户身份运行，如果你命令行是用管理员/其他账号启动的，该身份没有SQL Server的访问权限，就会直接连接失败。解决方法：要么给命令行运行所用的账号开通数据库权限，要么改成SQL Server账号密码验证的连接串。
• ODBC驱动位数不匹配
  检查命令行所用Python的位数（32位/64位），需要和系统里安装的SQL Server ODBC驱动位数一致。Python位数可以在命令行执行python -V后看输出提示，ODBC驱动可以在「ODBC数据源管理器」里查看，32位ODBC管理器路径是C:\Windows\SysWOW64\odbcad32.exe，64位是C:\Windows\System32\odbcad32.exe。
• 输出缓冲导致看不到报错
  Python默认对标准输出有缓冲，有时候程序崩溃前报错还没刷到控制台就退出了。可以运行时加-u参数禁用缓冲：python -u mypython.py，就能看到完整的输出和报错信息。
• 防火墙拦截
  检查系统防火墙是否允许命令行所用的python.exe进程访问SQL Server对应的端口（默认1433），IDLE的进程可能已经在防火墙白名单里，但单独的python.exe没有放行。
• Python环境不一致
  确认命令行的python和IDLE用的是同一个环境，执行where python（Windows）查看命令行python的路径，再在IDLE里执行import sys; print(sys.executable)对比路径是否一致，避免命令行用的是没有正确配置ODBC驱动的其他Python环境。

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