嘿，这个需求太贴合DRY原则了，把重复的邮件发送逻辑抽成独立服务绝对是让代码更整洁、易维护的好办法！我给你分步骤拆解实现方案：

1. 创建独立的邮件服务模块 #

首先新建一个专门处理邮件逻辑的文件，比如src/services/emailService.js（路径可以根据你的项目结构调整），把SendGrid的配置和发送逻辑都封装在这里：

// 引入SendGrid依赖
const sgMail = require('@sendgrid/mail');

// 从环境变量读取API密钥（别硬编码！）
sgMail.setApiKey(process.env.SENDGRID_API_KEY);

// 封装发送文档通知邮件的函数，接收文档数据作为参数
const sendDocumentNotification = async (documentData) => {
  try {
    // 根据需求构造邮件内容，灵活使用传入的文档数据
    const msg = {
      to: '目标收件邮箱', // 也可以把收件人作为参数传入，更灵活
      from: '你的验证过的发件邮箱', // 需在SendGrid后台完成域名/邮箱验证
      subject: `文档 ${documentData._id} 详情已生成`,
      html: `<h3>你请求的文档信息如下：</h3><pre>${JSON.stringify(documentData, null, 2)}</pre>`
    };

    // 发送邮件（send方法本身返回Promise，用await处理）
    await sgMail.send(msg);
    console.log('文档通知邮件发送成功');
    return { success: true };
  } catch (error) {
    // 捕获并格式化错误信息，方便上层处理
    const errorMsg = error.response?.body?.errors?.[0]?.message || error.message;
    console.error('邮件发送失败:', errorMsg);
    throw new Error(`邮件发送失败：${errorMsg}`);
  }
};

// 导出封装好的函数，供其他模块调用
module.exports = { sendDocumentNotification };

2. 在Express路由中调用邮件服务 #

现在回到你的路由文件（比如src/routes/api.js），只需要引入这个服务，然后在POST请求逻辑里调用它就行，路由代码会清爽很多：

const express = require('express');
const router = express.Router();
const YourMongoModel = require('../models/YourMongoModel'); // 你的MongoDB数据模型
const { sendDocumentNotification } = require('../services/emailService'); // 引入邮件服务

// POST /api/:id 路由处理逻辑
router.post('/api/:id', async (req, res) => {
  try {
    // 1. 从MongoDB查询对应ID的文档
    const targetDoc = await YourMongoModel.findById(req.params.id);
    if (!targetDoc) {
      return res.status(404).json({ message: '未找到对应ID的文档' });
    }

    // 2. 调用抽离的邮件服务，传入文档数据（转成普通对象避免MongoDB文档的特殊属性问题）
    await sendDocumentNotification(targetDoc.toObject());

    // 3. 返回成功响应
    res.status(200).json({ message: '文档信息已通过邮件发送' });
  } catch (error) {
    console.error('路由处理出错:', error);
    res.status(500).json({ message: error.message });
  }
});

module.exports = router;

3. 额外优化建议 #

• 环境变量管理：用dotenv包管理敏感配置，把SendGrid API密钥、发件邮箱等信息放在.env文件里，绝对不要硬编码到代码中。
• 通用化邮件函数：如果后续需要发送多种类型的邮件，可以在emailService.js里封装一个更通用的sendEmail函数，接收主题、内容、收件人等动态参数，或者拆分多个专项函数。
• 错误边界处理：在邮件服务里把底层错误包装成业务友好的提示，让路由层只需要专注处理请求响应逻辑。

这样一来，你的路由文件就只负责处理请求、查询数据库和返回响应，邮件逻辑完全抽离到独立模块，后续要修改邮件内容或者添加新的邮件类型，直接调整emailService.js即可，完美符合DRY原则！

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