在Kubernetes中执行SQL Server命令遇连接超时问题求助

核心问题拆解 #

你遇到的问题是：手动通过kubectl exec在SQL Server容器内执行SQL正常，但用YAML里的init容器或postStart hook、以及流水线执行时，出现Sqlcmd登录超时、TCP连接错误。核心矛盾是「手动操作时机可控」但「自动化执行时机/环境不可控」。

可能原因及对应解法 #

1. 自动化执行时机过早（最常见） #

SQL Server启动需要加载数据库、初始化服务，不是容器启动就立刻能接受连接。init容器默认在主容器启动后立刻执行，postStart hook更是容器启动时就触发，此时SQL服务还没就绪，自然连不上。

• 解法1：给主容器加就绪探针
  让K8s确认SQL Server完全就绪后，再启动init容器或执行后续操作：

  # 给SQL Server容器添加就绪探针
  readinessProbe:
    exec:
      command:
        - /opt/mssql-tools/bin/sqlcmd
        - -S
        - localhost
        - -U
        - sa
        - -P
        - YourStrong!Passw0rd  # 替换成你的SA密码
        - -Q
        - "SELECT 1"
    initialDelaySeconds: 30  # 首次检测延迟30秒，根据实际启动时间调整
    periodSeconds: 10        # 每10秒检测一次
    failureThreshold: 5      # 连续5次失败才标记未就绪
  

• 解法2：给自动化操作加延迟
  如果用postStart hook，直接加sleep延迟执行SQL：

  lifecycle:
    postStart:
      exec:
        command: ["sh", "-c", "sleep 60 && /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P YourStrong!Passw0rd -i /path/to/init.sql"]
  

2. 流水线与K8s集群网络不通 #

手动kubectl exec是直接进入容器内部访问localhost，但流水线可能在集群外部，无法直接访问SQL Server的ClusterIP或NodePort。

• 解法：
  1. 先在流水线机器上手动测试连接：

     sqlcmd -S <SQL_SERVICE_IP>:1433 -U sa -P YourStrong!Passw0rd -Q "SELECT 1"
     

     如果超时，说明网络有问题：
     • 检查流水线机器是否能访问K8s集群的NodeIP/ClusterIP
     • 确认安全组/防火墙开放了1433端口
     • 临时用kubectl port-forward暴露端口给流水线：

       kubectl port-forward svc/your-sql-service-name 1433:1433 &
       

       之后流水线连接localhost:1433即可。

3. 连接参数配置不一致 #

自动化执行时的连接字符串和手动操作时不一样：

• 手动kubectl exec用localhost即可，但流水线或init容器如果是外部连接，必须用SQL Server的Service全称（比如sql-svc.default.svc.cluster.local）或NodeIP+NodePort
• 检查SA密码是否和SQL Server容器启动时的SA_PASSWORD环境变量一致
• 确认SQL Server是否开启了TCP/IP协议（默认开启，但可通过sqlcmd -S tcp:localhost,1433强制指定TCP连接测试）

4. 容器资源不足导致启动缓慢 #

SQL Server对CPU和内存要求不低，如果资源分配不足，启动时间会大幅延长，超过自动化操作的等待超时。

• 解法：给SQL Server容器增加资源配额：

  resources:
    requests:
      cpu: "1"
      memory: "2Gi"
    limits:
      cpu: "2"
      memory: "4Gi"
  

验证步骤 #

1. 查看SQL Server容器日志，确认服务完全启动：

   kubectl logs <sql-pod-name> | grep "SQL Server is now ready for client connections"
   

2. 在流水线机器上手动测试sqlcmd连接，确保网络和参数没问题
3. 测试init容器或postStart hook的执行逻辑，确认能正常触发SQL执行

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