部署P1V3 SKU Azure函数时缺失WEBSITE_CONTENTAZUREFILECONNECTIONSTRING报错

数据老陈

2026-6-23

问题

将Python Azure函数部署至SKU为P1V3的应用服务计划（ASP），此前使用WEBSITE_CONTENTAZUREFILECONNECTIONSTRING连接字符串可正常运行。出于安全考虑，计划迁移至托管标识，编写的Bicep代码如下：

resource sampleFunctionApp 'Microsoft.Web/sites@2023-12-01' = {
  name: uniqueSampleFunctionName
  location: location
  kind: 'functionapp,linux'
  identity: {
    type: 'SystemAssigned, UserAssigned'
    userAssignedIdentities: {
      '${umi.id}': {}
    }
  }
  properties: {
    serverFarmId: hostingPlan.id
    siteConfig: {
      linuxFxVersion: 'Python|3.9'
      appSettings: [
        {
          name: 'AzureWebJobsStorage__accountName'
          value: storage.name
        }
        {
          name: 'WEBSITE_CONTENTSHARE'
          value: toLower(uniqueSampleFunctionName)
        }
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'WEBSITE_NODE_DEFAULT_VERSION'
          value: '~14'
        }
        {
          name: 'APPINSIGHTS_INSTRUMENTATIONKEY'
          value: appi.properties.InstrumentationKey
        }
        {
          name: 'FUNCTIONS_WORKER_RUNTIME'
          value: functionWorkerRuntime
        }
        {
          name: 'EventHubConn__fullyQualifiedNamespace'
          value: '${eventHubNamespaceName}.servicebus.windows.net'
        }
        {
          name: 'EventHubConn__tenantId'
          value: '72f988bf-86f1-41af-91ab-2d7cd011db47'
        }
        {
          name: 'EventHubConn__clientId'
          value: umi.properties.clientId
        }
        {
          name: 'CosmosConn__accountEndpoint'
          value: 'https://${cosmosdbName}.documents.azure.com:443/'
        }
        {
          name: 'CosmosConn__tenantId'
          value: '72f988bf-86f1-41af-91ab-2d7cd011db47'
        }
        {
          name: 'CosmosConn__clientId'
          value: umi.properties.clientId
        }
      ]
      ftpsState: 'FtpsOnly'
      minTlsVersion: '1.2'
    }
    httpsOnly: true
  }
}

部署时出现错误：

[{"code":"BadRequest","target":"/subscriptions/e2108557-56b7-4d88-88e4-fdc4f0468d32/resourceGroups/wcx-rg-equal-mas-apps-dev/providers/Microsoft.Web/sites/mas-sample-func-lmyvtb5moi22y","message":"{\r\n  \"Code\": \"BadRequest\",\r\n  \"Message\": \"Required parameter WEBSITE_CONTENTAZUREFILECONNECTIONSTRING is missing.\",\r\n  \"Target\": null,\r\n  \"Details\": [\r\n    {\r\n      \"Message\": \"Required parameter WEBSITE_CONTENTAZUREFILECONNECTIONSTRING is missing.\"\r\n    },\r\n    {\r\n      \"Code\": \"BadRequest\"\r\n    },\r\n    {\r\n      \"ErrorEntity\": {\r\n        \"ExtendedCode\": \"01010\",\r\n        \"MessageTemplate\": \"Required parameter {0} is missing.\",\r\n        \"Parameters\": [\r\n          \"WEBSITE_CONTENTAZUREFILECONNECTIONSTRING\"\r\n        ],\r\n        \"Code\": \"BadRequest\",\r\n        \"Message\": \"Required parameter WEBSITE_CONTENTAZUREFILECONNECTIONSTRING is missing.\"\r\n      }\r\n    }\r\n  ],\r\n  \"Innererror\": null\r\n}"}]}}]

查阅微软官方文档后得知，已弃用的ASP可移除WEBSITE_CONTENTAZUREFILECONNECTIONSTRING应用设置，而当前使用的是P1V3 SKU的ASP，认为无需配置该设置。请问是否遗漏了关键配置？该设置在当前场景中是否仍属必要？

解决方案

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING的必要性：对于P1V3这类弹性Premium SKU的ASP，若函数应用使用Azure Files存储文件内容（即保留了WEBSITE_CONTENTSHARE设置），则仍需配置内容存储的访问凭证——只是不需要明文连接字符串，可改用托管标识替代。你当前保留了WEBSITE_CONTENTSHARE，说明仍依赖Azure Files存储代码，因此必须提供合法的访问方式，否则部署会报错。
托管标识替代的配置步骤：
1. 为用户托管标识（UMI）分配目标存储账户的Storage File Data Contributor角色，确保其有权访问指定的文件共享。
2. 在函数应用的应用设置中，移除WEBSITE_CONTENTAZUREFILECONNECTIONSTRING，添加以下两个配置：
  - WEBSITE_CONTENTAZUREFILEACCOUNTNAME：值为存储账户名称
  - WEBSITE_CONTENTAZUREFILEIDENTITYCLIENTID：值为用户托管标识的Client ID
配置验证：完成上述调整后，函数应用将通过托管标识认证访问Azure Files，既满足安全要求，也符合部署的参数要求，不会再出现缺失连接字符串的错误。

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