Azure Functions v3迁移v4启动报错：SSL连接无法建立

1. 核查Azure Storage连接配置 #

• 确认生产环境的AzureWebJobsStorage连接字符串配置正确，未在迁移过程中遗漏或篡改。可通过Azure门户进入函数应用的「配置→应用设置」页面核对，同时确保连接字符串指向的存储账户状态正常，无权限或到期问题。
• 若函数应用与存储账户采用虚拟网络隔离部署，检查存储账户的防火墙规则是否允许函数应用所在子网/IP访问。v4运行时对网络访问的校验逻辑更严格，需确认原有v3的网络规则适配v4环境。

2. 更新Extension Bundle版本 #

当前host.json中使用的[1.*, 2.0.0)扩展包版本与v4运行时存在兼容性隐患，建议升级至v2.x系列，这是Durable Functions v4的推荐配置。修改后的host.json如下：

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[2.*, 3.0.0)"
  }
}

3. 配置强制TLS版本与运行时参数 #

在函数应用的应用设置中添加以下配置项，强制适配v4运行时的网络要求：

• 添加WEBSITE_TLS_VERSION，值设为1.2（确保存储连接使用兼容的高版本TLS）
• 添加AZURE_FUNCTIONS_ENVIRONMENT，值设为Production（明确运行环境，避免默认配置差异）
• 添加WEBSITE_USE_PLACEHOLDER，值设为0（规避占位符机制导致的连接初始化异常）

4. 检查自定义Startup类代码 #

错误提示明确指向外部Startup类的配置构建问题，若项目存在自定义Startup类：

• 确认其中初始化存储客户端/HTTP客户端的代码使用v4兼容的SDK（如Azure.Storage.Blobs而非旧版WindowsAzure.Storage）
• 检查客户端是否配置了正确的SSL验证逻辑，避免因证书校验失败导致连接重置

5. 验证存储账户SSL配置 #

登录Azure门户进入对应存储账户的「配置→加密」页面，确认已启用「强制使用SSL」，且SSL最低版本设置为TLS 1.2及以上。若存储账户SSL版本过低，v4运行时的客户端会直接拒绝建立连接。

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