如何在Azure Node.js编程模型v4中优化SendGrid邮件发送方案？

背景 #

我的目标是通过Azure Function从Azure静态Web应用（SWA）的联系页面发送邮件，目前已通过SendGrid实现功能，但希望优化方案：

• 原本尝试用Azure Communications Services发送邮件，本地SWA模拟环境正常，但部署到Azure后静默失败，因此改用SendGrid（每日100封免费额度，适配需求）。
• 现有参考资料多基于Azure Node.js编程模型v3，但我选择了当前默认的v4版本。
• 集成SendGrid时发现，在v4的异步函数中必须await .send操作，否则函数会直接退出返回"unexpected state"（本地可能偶发成功，但不可靠）；之前误以为then/catch可以替代await处理Promise，暴露了异步编程的认知不足。

优化方向 #

• 统一异步代码风格：避免await与then/catch混合使用，改用try/catch配合await，代码逻辑更清晰易维护。
• 配置初始化复用：SendGrid的API Key设置只需初始化一次，无需在每次函数调用时重复执行，可移到函数外部。
• 限制请求方法：邮件发送仅需支持POST方法，关闭GET请求（避免被浏览器预请求、爬虫误触发）。
• 添加输入验证：对请求体中的核心参数（收件人、发件人、主题、内容）做校验，拦截无效请求。
• 增强错误处理：分层捕获不同类型错误（请求格式错误、SendGrid API错误、未知错误），返回更友好的提示，同时避免泄露敏感错误信息。
• 细化日志输出：增加请求接收、参数验证、邮件发送状态等日志，方便排查问题。
• 调整权限级别：当前authLevel设为anonymous，建议根据实际需求改为function或admin，防止未授权调用。

优化后的代码 #

const { app } = require("@azure/functions");
const sgMail = require("@sendgrid/mail");

// 全局初始化SendGrid配置，仅执行一次
sgMail.setApiKey(process.env.SENDGRID_API_KEY);

app.http("sendGrid", {
  methods: ["POST"], // 仅允许POST请求
  authLevel: "function", // 可根据需求调整为admin或anonymous
  handler: async (request, context) => {
    try {
      // 解析并验证请求体
      const requestBody = await request.json();
      const requiredFields = ["to", "from", "subject", "text"];
      const missingFields = requiredFields.filter(field => !requestBody[field]);
      
      if (missingFields.length > 0) {
        const errorMsg = `缺少必要参数：${missingFields.join(", ")}`;
        context.log.error(errorMsg);
        return { status: 400, body: errorMsg };
      }

      const timestamp = new Date().toISOString();
      const msg = {
        to: requestBody.to,
        from: requestBody.from, // 需与SendGrid验证的发件人地址一致
        subject: `${requestBody.subject} [${timestamp}]`,
        text: requestBody.text,
        html: requestBody.html || `<strong>${requestBody.text}</strong>`
      };

      context.log.info(`准备发送邮件至${msg.to}，主题：${msg.subject}`);
      await sgMail.send(msg);
      const successMsg = `邮件 ${timestamp} 发送成功`;
      context.log.info(successMsg);
      return { status: 200, body: successMsg };

    } catch (error) {
      let errorMsg = "邮件发送失败";
      let statusCode = 500;

      if (error.response) {
        // 处理SendGrid API返回的结构化错误
        errorMsg = `SendGrid错误：${error.response.body.errors.map(e => e.message).join("; ")}`;
        statusCode = error.response.statusCode;
        context.log.error(`SendGrid错误详情：${JSON.stringify(error.response.body)}`);
      } else if (error instanceof SyntaxError) {
        // 处理请求体JSON解析错误
        errorMsg = "请求体格式错误，需为合法JSON";
        statusCode = 400;
        context.log.error(`JSON解析错误：${error.message}`);
      } else {
        // 处理其他未知错误
        context.log.error(`未知错误：${error.message}`);
      }

      return { status: statusCode, body: errorMsg };
    }
  }
});

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