Azure DevOps中az创建的MySQL弹性服务器无法用mysql客户端连接

核心原因：MySQL客户端用户名格式错误 #

Azure MySQL 弹性服务器（Flexible Server）的用户名格式不需要添加@服务器名后缀，你在mysql客户端命令中使用了$adminusername@$sername的格式，这与弹性服务器的认证要求不符。

az mysql flexible-server connect命令能成功，是因为该命令适配了弹性服务器的用户名规则，直接使用纯用户名即可；而手动创建时你大概率用了正确的纯用户名格式，因此能正常连接。

修复步骤 #

1. 修正mysql命令的用户名参数：
   将所有mysql命令中的--user=$adminusername@$sername改为--user=$adminusername，示例：

   mysql --host=$sername.mysql.database.azure.com \
         --user=$adminusername \
         --password=$adminpassword \
         --ssl-mode=REQUIRED \
         --execute="DROP DATABASE IF EXISTS flexibleserverdb;"
   

2. 补充潜在问题检查：

   • 变量映射一致性：确认流水线变量传递正确：
     • 脚本中的$location需对应变量里的region，确保流水线已将region赋值给location
     • 脚本中的$mysqlversion需对应变量里的mysqlserverversion，保证变量名映射无误
     • 确认$dbname变量已在流水线中定义，否则CREATE DATABASE命令会报错
   • 防火墙规则生效延迟：在创建防火墙规则后添加短暂等待，避免因规则未即时生效导致连接拒绝：

     az mysql flexible-server firewall-rule create --resource-group $resourcegroup \
                                         --name $sername \
                                         --rule-name AllowAllIPs \
                                         --start-ip-address 0.0.0.0 \
                                         --end-ip-address 255.255.255.255 
     # 等待规则生效
     sleep 30
     

   • 强制SSL连接：弹性服务器默认强制SSL，所有mysql命令建议统一添加--ssl-mode=REQUIRED参数，符合安全要求

验证修正后的脚本示例 #

az mysql flexible-server create --resource-group $resourcegroup \
                       --name $sername \
                       --location $location \
                       --admin-user $adminusername \
                       --admin-password $adminpassword \
                       --sku-name $sku \
                       --version $mysqlversion \
                       --yes \
                       --tags CreatedBy=AzDO

az mysql flexible-server firewall-rule create --resource-group $resourcegroup \
                                      --name $sername \
                                      --rule-name AllowAllIPs \
                                      --start-ip-address 0.0.0.0 \
                                      --end-ip-address 255.255.255.255 

# 等待防火墙规则生效
sleep 30

# 验证服务器连接
az mysql flexible-server connect -n $sername -u $adminusername -p $adminpassword -d flexibleserverdb

# 修正后的mysql命令
mysql --host=$sername.mysql.database.azure.com \
      --user=$adminusername \
      --password=$adminpassword \
      --ssl-mode=REQUIRED \
      --execute="DROP DATABASE IF EXISTS flexibleserverdb;"

mysql --host=$sername.mysql.database.azure.com \
      --user=$adminusername \
      --password=$adminpassword \
      --ssl-mode=REQUIRED \
      --execute="CREATE DATABASE $dbname;"

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