.NET 6 Blazor WebAssembly部署Azure后SendGrid发邮件报400错误

1. 核心问题：Blazor WASM客户端无法读取Azure App Service的环境变量 #

Blazor WebAssembly是客户端运行的应用，Environment.GetEnvironmentVariable只能读取浏览器环境的变量，无法获取Azure App Service层面配置的应用设置。本地运行时能拿到值，是因为调试环境下系统/launchSettings的环境变量被注入到进程中，但部署后客户端完全运行在用户浏览器里，根本访问不到Azure的服务器端环境变量。

解决方式：

• 推荐方案：将发送邮件的逻辑迁移到后端API（比如配套的ASP.NET Core Web API），客户端仅提交表单数据到自己的后端，由后端调用SendGrid API。这样既避免暴露SendGrid密钥，也能正常读取Azure App Service的应用设置。
• 若坚持客户端调用（不推荐，存在密钥泄露风险）：将SendGrid配置写入wwwroot/appsettings.json，或在Azure App Service中用__代替配置路径的冒号（比如键名设为SendGrid__EmailTo、SENDGRID_API_KEY），通过IConfiguration读取配置，而非Environment.GetEnvironmentVariable。

2. 捕获SendGrid的具体错误信息 #

当前代码仅判断了响应状态码，没有获取400错误的具体内容，无法定位根因。修改代码捕获错误详情：

else
{
    var errorContent = await response.Body.ReadAsStringAsync();
    // 可将errorContent写入日志或返回给前端排查
    return new ServiceResponse<Contact> 
    { 
        Success = false,
        Message = $"邮件发送失败: {errorContent}"
    };
}

常见的400错误原因包括：API密钥无效、发件人地址未验证、收件人格式错误、请求内容不符合SendGrid规范等。

3. 验证SendGrid发件人地址合法性 #

SendGrid禁止使用未验证的发件人地址发送邮件（防止垃圾邮件）。你当前代码中直接用用户提交的info.Email作为发件人，若该地址未在SendGrid控制台完成单地址验证或域名验证，SendGrid会直接返回400错误。

解决方式：

• 在SendGrid控制台验证一个固定的发件人地址（比如noreply@yourdomain.com），代码中改用这个固定地址作为发件人，将用户的邮箱和姓名放到邮件的回复地址或正文中。

4. 检查API Management的拦截规则 #

APIM可能存在以下问题导致请求被篡改或拦截：

• 检查APIM是否添加了修改请求头、内容类型的政策，导致SendGrid无法识别请求格式。
• 确认APIM允许出站请求到SendGrid的域名（api.sendgrid.com），没有IP或域名黑名单限制。
• 若客户端通过APIM转发请求到自己的后端，检查APIM是否正确传递了表单数据，没有丢失字段。

5. 非HTTPS环境的影响 #

SendGrid的API仅接受HTTPS请求，而你的站点未配置SSL证书（HTTP访问）：

• 浏览器可能因混合内容策略阻止客户端向HTTPS的SendGrid API发送请求，导致请求失败。
• 即使请求发出，SendGrid可能直接拒绝HTTP请求返回400。

解决方式：为Azure App Service配置免费的SSL证书（Azure提供App Service证书或Let's Encrypt证书），强制站点使用HTTPS访问。

6. 确认配置项是否正确加载 #

检查SendGrid:EmailTo、SendGrid:EmailName等配置是否在部署环境中正确读取：

• 若使用appsettings.json，确认部署时该文件已正确上传到wwwroot目录。
• 若使用Azure App Service应用设置，配置键名需用__代替冒号（比如SendGrid__EmailTo），Blazor WASM才能正确识别配置路径。

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