Docker部署Microsoft SQL Server后Python pyodbc连接失败调试求助

让我们一步步拆解你的问题，从日志里最明确的错误开始排查：

1. 先解决ODBC驱动找不到的核心问题 #

你的ODBC调试日志反复出现Can't open lib 'ODBC Driver 17 for SQL Server' : file not found，这是连接失败的首要原因。结合你给出的odbcinst -j输出，驱动配置文件存在/usr/local/etc/odbcinst.ini，我们需要确保这个文件里有正确的驱动配置：

• 先检查当前配置：

  cat /usr/local/etc/odbcinst.ini
  

• 如果没有ODBC Driver 17的条目，手动添加（根据你的系统调整Driver路径：Mac是.dylib，Linux是.so）：

  [ODBC Driver 17 for SQL Server]
  Description=Microsoft ODBC Driver 17 for SQL Server
  Driver=/usr/local/lib/libmsodbcsql.17.dylib  # Mac路径；Linux路径通常是/usr/lib64/libmsodbcsql-17.so
  UsageCount=1
  

• 验证驱动是否能被识别：

  odbcinst -q -d -n "ODBC Driver 17 for SQL Server"
  

  如果能输出驱动的配置信息，说明驱动已经正确注册。

2. 修正连接字符串的冲突配置 #

你的连接字符串里同时使用了UID=sa;PWD=xxx和Trusted_Connection=yes，这两个配置是互斥的——要么用SQL Server账号密码登录，要么用Windows身份验证（Trusted_Connection），不能同时启用。修改后的连接字符串应该是这样：

import pyodbc
try:
    conn_str = (
     r"Driver={ODBC Driver 17 for SQL Server};"
     r"Server=127.0.0.1,1433;"  # 显式指定端口，避免端口映射的潜在问题
     r"Database=testdb;"
     r"UID=sa;"
     r"PWD=mySecretPassword1234567890;"
    )
    conn = pyodbc.connect(conn_str)
    print("连接成功！")
except pyodbc.Error as e:
    print(f"连接失败详情：{e}")
    print(f"SQL状态码：{e.args[0]}")
    print(f"错误描述：{e.args[1]}")

另外注意：testdb数据库需要预先在SQL Server中创建，否则会报“数据库不存在”的错误。你可以进入Docker容器创建它：

# 先获取容器ID/名称：docker ps
docker exec -it <你的容器ID或名称> /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P mySecretPassword1234567890
# 在sqlcmd里执行以下命令
CREATE DATABASE testdb;
GO

3. 排查Docker容器的崩溃问题 #

你提到连续5次系统崩溃，大概率是容器本身启动失败导致的。先确认容器状态：

• 查看所有容器的运行状态：

  docker ps -a
  

• 如果容器处于退出状态，查看启动日志找崩溃原因：

  docker logs <你的容器ID或名称>
  

• 特别注意SA密码的复杂度：SQL Server要求密码至少8位，必须包含大小写字母、数字和特殊字符。你的密码只有数字和字母，可能不符合要求导致容器启动失败，可以修改密码为mySecretPassword123!这类包含特殊字符的试试，同时更新Docker启动命令和连接字符串里的密码。
• 检查端口冲突：Mac上1433端口可能被其他程序占用，用以下命令排查：

  lsof -i :1433
  

  如果被占用，修改Docker端口映射为1434：

  docker run -e 'ACCEPT_EULA=Y' -e 'SA_PASSWORD=mySecretPassword123!' -p 1434:1433 -d mcr.microsoft.com/mssql/server:2017-latest
  

  对应的连接字符串里的Server要改成127.0.0.1,1434。

4. 用原生工具验证连接，排除pyodbc问题 #

如果以上步骤都做了还是无法连接，建议先用sqlcmd工具测试连接，确认是pyodbc的问题还是数据库本身的问题：

• Mac上可以先安装mssql-tools：brew install mssql-tools
• 执行连接测试：

  sqlcmd -S 127.0.0.1,1433 -U sa -P mySecretPassword123!
  

  如果能成功进入sqlcmd交互界面，说明数据库和网络没问题，问题出在pyodbc的配置上；如果连接失败，继续排查Docker容器和网络设置。

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