如何解决本地连接Docker内MSSQL实例pyodbc登录超时问题

pyodbc抛出HYT00登录超时错误，本质是宿主机未和容器内的MSSQL服务建立有效TCP通信，你当前排查的容器内ODBC驱动配置和本问题无关——该配置仅在容器内部运行ODBC程序时生效，宿主机连接需要确认宿主机本地的ODBC驱动安装正常。

按以下步骤逐一排查修复：

• 校验容器端口映射配置
  执行docker ps查看运行中的MSSQL容器配置，端口列必须存在0.0.0.0:1433->1433/tcp的绑定记录。如果没有该记录，说明启动容器时未配置端口映射，需要删除现有容器后重新启动，启动命令必须包含端口映射参数：

  docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong@Passw0rd>" -p 1433:1433 -d mcr.microsoft.com/mssql/server:2022-latest
  

  注意：MSSQL强制要求SA密码长度不低于8位，同时包含大小写字母、数字、特殊符号，密码不符合规则时容器会静默启动失败，不会弹出显性报错
• 排查宿主机端口占用问题
  如果端口映射配置正常，执行对应命令检查1433端口占用：
  • Windows环境：netstat -ano | findstr :1433
  • Linux/macOS环境：ss -tulpn | grep 1433
    正常情况下1433端口的监听进程应为docker-proxy，如果端口被本地其他SQL Server实例、第三方程序占用，要么停止占用端口的进程，要么修改容器端口映射规则（比如将容器1433端口映射到宿主机1434端口），修改后连接串的server参数需要对应调整为localhost,1434。
• 修复连接串加密兼容问题
  ODBC Driver 17及以上版本默认强制加密数据库连接，容器内MSSQL默认使用自签名证书，未配置证书信任时会卡在TLS握手阶段触发超时。需要在连接串中添加证书信任、超时时间配置，修改后的Python连接代码如下：

  import pyodbc
  server = 'localhost,1433'
  database = 'TestDB'
  username = 'sa'
  password = '<YourStrong@Passw0rd>'
  conn_str = (
      'DRIVER={ODBC Driver 17 for SQL Server};'
      f'SERVER={server};DATABASE={database};UID={username};PWD={password};'
      'Encrypt=yes;TrustServerCertificate=yes;Connection Timeout=30'
  )
  cnxn = pyodbc.connect(conn_str)
  cursor = cnxn.cursor()
  

• 验证基础网络连通性
  先跳过Python脚本，直接在宿主机测试端口连通性：执行telnet localhost 1433，如果连接直接被拒绝，需要检查宿主机防火墙规则是否放通1433端口的通信权限；如果端口能正常连通，再执行上述Python脚本即可正常建立连接。

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