Bicep模板部署报错：sqlAdministratorLoginPassword参数无效

错误根源 #

你的部署参数文件中包含了sqlAdministratorLoginPassword参数，但目标模板sqldb.bicep并未定义这个参数——因为密码是通过Key Vault动态获取的，不需要从外部参数传入，Pipeline部署时会严格校验参数与模板的匹配性，因此触发验证错误。

具体解决步骤 #

• 清理参数文件
  打开你的部署参数文件（比如main.parameters.json），直接删除其中的sqlAdministratorLoginPassword参数条目，只保留模板支持的name、sqlAdministratorLogin、sqlSkuName、sqldatabaseNames、keyVaultName、keyVaultResourceGroup这几个参数。

• 确认模块调用与密码获取逻辑
  确保main.bicep中引用sqldb模块时，没有传递多余的密码参数，示例代码如下：

  module sqlDbModule 'br:yourregistry.azurecr.io/bicep/modules/sqldb:v1' = {
    name: 'sqlDbDeployment'
    params: {
      name: sqlServerName
      sqlAdministratorLogin: sqlAdminLogin
      sqlSkuName: sqlSku
      sqldatabaseNames: dbNames
      keyVaultName: kvName
      keyVaultResourceGroup: kvResourceGroup
    }
  }
  

  同时检查sqldb.bicep内部，密码是通过Key Vault引用获取的，而非外部参数传入，示例逻辑：

  param keyVaultName string
  param keyVaultResourceGroup string
  
  // 从Key Vault读取密码
  var sqlAdminPassword = getSecret('${keyVaultResourceGroup}/${keyVaultName}', 'sql-admin-password')
  
  resource sqlServer 'Microsoft.Sql/servers@2022-05-01-preview' = {
    name: name
    location: resourceGroup().location
    properties: {
      administratorLogin: sqlAdministratorLogin
      administratorLoginPassword: sqlAdminPassword
      // 其他SQL Server配置项
    }
  }
  

• 检查Pipeline配置
  查看Azure Pipeline中的部署任务（比如AzureResourceManagerTemplateDeployment），如果有手动传递sqlAdministratorLoginPassword参数的配置，直接删除这部分内容。

• 本地预验证
  修改完成后，先在本地用命令验证模板与参数的匹配性，避免再次触发Pipeline错误：

  az deployment group validate --resource-group your-rg --template-file main.bicep --parameters main.parameters.json
  

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