使用pytest执行pyodbc.connect()时抛出HY000错误求助

以下是几个针对性的排查方向：

• 调整加密连接参数
  ODBC Driver 18默认强制加密连接，若测试环境未正确配置SSL证书信任，会触发这类模糊错误。可以在连接字符串中添加参数临时验证：

  connection_string = 'DRIVER={ODBC Driver 18 for SQL Server};SERVER=tcp:database.windows.net;PORT=1433;DATABASE=database;UID=admin;PWD=pass;Encrypt=yes;TrustServerCertificate=yes;'
  

  如果连接成功，说明是证书信任问题，后续需配置正确的根证书。

• 验证测试环境网络连通性
  即使项目环境正常，测试环境可能存在防火墙、代理或网络策略限制，导致无法访问Azure SQL Server的1433端口。用以下命令测试端口连通性：

  # Windows
  telnet database.windows.net 1433
  # Linux/macOS
  nc -zv database.windows.net 1433
  

  确保网络通路无阻塞。

• 检查账号权限与凭证有效性
  确认测试用的admin账号拥有目标数据库的登录权限，同时检查密码是否包含特殊字符（如分号、引号），这类字符需要转义后才能正确写入连接字符串。另外，Azure SQL Server需确保使用SQL身份验证模式，而非Windows身份验证。

• 重新确认依赖兼容性
  即使虚拟环境依赖一致，也可尝试重新安装pyodbc确保无损坏：

  pip uninstall pyodbc -y
  pip install pyodbc
  

  同时用odbcinst -j（Linux/macOS）或ODBC数据源管理器（Windows）确认驱动已正确安装。

• 开启pyodbc调试日志
  启用调试模式获取详细连接日志，定位具体问题：

  import pyodbc
  pyodbc.set_trace(True)
  pyodbc.set_trace_file(open('pyodbc_trace.log', 'w'))
  conn = pyodbc.connect(connection_string)
  

  查看生成的pyodbc_trace.log，里面会记录连接过程的交互细节，有助于找到错误根源。

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