Docker容器中Azure Function连接本地SQL Server超时问题求助

排查与修复步骤 #

1. 本地SQL Server网络配置检查 #

• 启用TCP/IP远程连接：打开SQL Server配置管理器，导航到SQL Server网络配置 → 目标实例的TCP/IP，右键启用。进入TCP/IP属性的「IP地址」标签，找到IPAll区域，设置TCP端口为1433（默认端口），重启SQL Server服务生效。
• 放行防火墙端口：在Windows防火墙中添加入站规则，允许TCP 1433端口的流量；或临时关闭防火墙，验证是否为防火墙阻断连接。

2. Docker容器网络连通性验证 #

• 测试端口可达性：进入容器内部，执行以下命令检查host.docker.internal的1433端口是否开放：

  nc -zv host.docker.internal 1433
  # 或安装telnet后执行
  telnet host.docker.internal 1433
  

  若不通，检查Docker Desktop设置：进入「Settings」→「Resources」→「Network」，确保WSL 2后端已启用（若使用WSL环境），确认host.docker.internal能正确解析到本地主机IP。

3. 环境变量转义正确性验证 #

• 检查容器内实际环境变量：进入容器执行echo $DB_HOST，预期输出应为host.docker.internal\SQLEXPRESS（单个反斜杠）。若显示双反斜杠，调整Docker Compose的写法，用单引号包裹变量值：

  - DB_HOST='host.docker.internal\SQLEXPRESS'
  

4. ODBC配置优化 #

• 验证驱动安装：在容器内执行odbcinst -q -d，确认输出包含[ODBC Driver 17 for SQL Server]，且驱动路径与odbcinst.ini一致。
• 移除冗余ODBC配置：你的代码通过环境变量构建连接字符串，odbc.ini中的Server和Database配置可能造成冲突，建议注释或删除这两行：

  # Server=host.docker.internal\\SQLEXPRESS
  # Database=dev.local
  

5. SQL Server登录权限检查 #

• 启用混合身份验证：在SSMS中右键服务器→「属性」→「安全性」，选择「SQL Server和Windows身份验证模式」，重启服务。
• 验证账号权限：确认DB_USERNAME对应的SQL登录账号存在，拥有dev.local数据库的访问权限，且允许从容器所在IP段远程登录。

快速验证流程 #

1. 本地测试：在主机执行sqlcmd -S host.docker.internal\SQLEXPRESS -U user -P admin -d dev.local，确认账号和实例连接正常。
2. 容器内测试：进入容器安装mssql-tools，执行相同命令验证连接：

   apt-get update && apt-get install -y mssql-tools
   sqlcmd -S host.docker.internal\SQLEXPRESS -U user -P admin -d dev.local
   

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