Azure Function使用SendGrid发送邮件时ApiKey属性无法解析怎么解决

问题根因 #

Azure Functions运行时无法读取到SendGrid绑定所需的API密钥配置，你当前local.settings.json中的AzureWebJobsSendGridApiKey配置项处于注释状态，自然无法返回有效值。

修复步骤 #

本地开发环境 #

• 先到SendGrid后台生成拥有**邮件发送（Mail Send）**权限的API密钥
• 取消local.settings.json中AzureWebJobsSendGridApiKey行的注释，将生成的API密钥填入对应位置，修改后配置参考：

{ 
  "IsEncrypted": false,
  "Values": 
  {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true", 
    "FUNCTIONS_WORKER_RUNTIME": "dotnet", 
    "AzureWebJobsServiceBus": "你的服务总线连接字符串",
    "AzureWebJobsSendGridApiKey": "你生成的SendGrid API密钥"
  }
}

• 如果你在函数代码的SendGrid绑定特性中自定义了ApiKey对应的配置名称，例如[SendGrid(ApiKey = "CustomSendGridKey")]，则需要在Values节点下新增键为CustomSendGridKey的配置项，值为你的SendGrid API密钥。

云端Azure环境部署后 #

local.settings.json仅用于本地开发，部署到Azure后需要在函数App配置页添加对应配置：

• 进入对应函数App的「设置」-「环境变量」页面
• 新增应用程序配置，键为AzureWebJobsSendGridApiKey（或你自定义的配置名），值为SendGrid API密钥，保存后重启函数App即可生效。

排查校验项 #

• 确认SendGrid API密钥已开启Mail Send权限，没有IP、域名等发送限制
• 确认配置值前后无多余空格、换行符，避免密钥解析失败
• 无论是进程内还是隔离进程模型的Azure Functions，配置规则均适用。

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