无Docker环境Azure SQL数据推送正常，Docker环境登录超时故障排查

以下是可能导致Docker环境下连接Azure SQL Database登录超时的常见原因：

• 容器网络连通性异常：Docker默认桥接网络可能无法访问Azure SQL的公网端点。可在容器内执行ping <your-azure-sql-server>.database.windows.net或telnet <your-azure-sql-server>.database.windows.net 1433测试端口连通性，若不通需排查宿主机网络权限或调整容器网络模式（如临时切换为host模式验证）。

• ODBC驱动未正确安装：本地环境已配置ODBC Driver 17 for SQL Server，但Docker镜像中可能缺失该驱动。需在Dockerfile中添加驱动安装步骤，例如基于Ubuntu镜像：

  RUN apt-get update && apt-get install -y msodbcsql17 unixodbc-dev
  

• Azure SQL防火墙规则限制：Docker容器的出口IP未被Azure SQL防火墙允许。需将容器所在宿主机的公网IP添加至Azure SQL的防火墙允许列表，或临时开启"允许Azure服务和资源访问此服务器"选项用于测试。

• DNS解析失败：容器内DNS服务器无法解析Azure SQL的域名。可在容器内执行nslookup <your-azure-sql-server>.database.windows.net验证解析结果，若异常可在启动容器时指定公共DNS服务器（如docker run --dns 8.8.8.8 ...）。

• 连接字符串配置错误：需确保连接字符串包含Azure SQL强制要求的加密参数，SqlAlchemy连接URL格式应为：

  "mssql+pyodbc://<username>:<password>@<server>.database.windows.net/<dbname>?driver=ODBC+Driver+17+for+SQL+Server&Encrypt=yes&TrustServerCertificate=no"
  

  检查是否遗漏Encrypt=yes参数，或驱动名称拼写错误。

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