AKS中通过Helm部署SonarQube连接SQL Server失败求助

• 核对Helm配置参数准确性

  • 确认sonar.jdbc.url与DBeaver验证的地址完全一致，注意格式细节：比如Azure SQL需包含encrypt=true;trustServerCertificate=true（按需调整），实例名、端口、数据库名不能遗漏
  • 检查sonar.jdbc.username和sonar.jdbc.password是否正确，若密码含特殊字符（如$、@），避免在Helm命令行直接传递，改用values.yaml配置或加密Secret注入，防止转义失效
  • 确认SQL Server已开启混合身份验证模式，SonarQube使用SQL登录账号，必须依赖该模式

• 验证AKS到SQL Server的网络连通性

  • 在AKS集群内启动测试Pod：kubectl run mssql-test --image=mcr.microsoft.com/mssql-tools --command -- sleep infinity，进入Pod后执行sqlcmd -S <server>:<port> -U <username> -P <password> -d <dbname>，直接测试连接是否正常
  • 若为Azure SQL Database，检查防火墙规则是否包含AKS集群的出站IP或VNet集成后的子网地址
  • 排查AKS集群的网络策略、NSG规则，确认1433端口（SQL Server默认端口）的出站流量未被阻断

• 检查SonarQube Pod的实际生效配置

  • 执行kubectl describe pod <sonarqube-pod-name>查看Pod环境变量，确认JDBC相关参数是否正确注入
  • 进入Pod查看实际配置文件：kubectl exec <sonarqube-pod-name> -- cat /opt/sonarqube/conf/sonar.properties | grep jdbc，核对参数是否与Helm配置一致，排查是否有自定义ConfigMap/Secret覆盖配置

• 排查SQL Server端的登录与权限问题

  • 登录SQL Server管理工具，查看SQL Server日志（路径：管理->SQL Server日志），获取登录失败的详细原因（如密码错误、账号锁定、数据库不存在）
  • 确认所用SQL登录账号拥有目标数据库的db_owner权限（或SonarQube所需的最小权限：创建表、读写数据等）
  • 检查登录账号的登录来源限制，确保允许AKS集群的IP范围访问

• 核对版本兼容性

  • 确认SonarQube 9.7.1与所用SQL Server版本（如SQL Server 2019/2022、Azure SQL Database）兼容
  • 检查SonarQube容器内的JDBC驱动版本：kubectl exec <sonarqube-pod-name> -- ls /opt/sonarqube/lib/jdbc/mssql/，若驱动版本不匹配，可替换为对应SQL Server版本的兼容驱动

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