本地正常服务器异常：ExcelJS+Nodemailer发送Excel问题排查

1. 文件生成与存储问题 #

• 服务器文件权限：本地写文件权限宽松，但服务器上生成Excel的目录可能无读写权限。检查代码中的文件路径，比如./temp/excel.xlsx，确保服务器上temp目录存在且当前进程有读写权限。建议用绝对路径替代相对路径，避免路径解析错误，也可提前用fs.accessSync检查目录权限。
• 临时文件管理：本地测试后可能手动清理了临时文件，但服务器上若未自动清理，可能导致文件占用或磁盘满额。务必在邮件发送完成后删除临时文件，比如在Nodemailer的回调或await之后调用fs.unlinkSync。

2. Nodemailer配置问题 #

• 端口与加密配置：本地常用的25端口在多数服务器会被封禁，建议改用465（SSL加密）或587（TLS加密）。调整transporter配置：

  const transporter = nodemailer.createTransport({
    host: 'smtp.example.com',
    port: 465,
    secure: true, // 465端口设为true，587端口设为false
    auth: {
      user: 'your-email@example.com',
      pass: 'your-app-specific-password' // 优先用应用专用密码，而非邮箱原密码，尤其Gmail、Outlook等服务商
    }
  });
  

• 服务器安全组限制：检查服务器安全组是否开放了SMTP端口（465/587）的出站流量，若未开放需添加对应规则。
• 邮件服务商限制：部分服务商（如Gmail）会拦截服务器端的陌生登录请求，需开启“低安全应用访问”（或使用应用专用密码），同时确认服务器IP未被列入服务商黑名单。

3. 数据库连接问题 #

• IP白名单设置：本地用localhost连接数据库，服务器端数据库可能仅允许特定IP访问，需在数据库控制台将服务器公网/内网IP加入白名单。
• 连接字符串配置：服务器上的数据库连接字符串需替换为数据库的公网/内网地址，同时核对用户名、密码，避免因环境变量配置错误导致连接失败。

4. 代码异步逻辑问题 #

• 异步操作未等待：生成Excel是异步操作，若发送邮件的代码未等待Excel生成完成就执行，本地可能因性能巧合正常，但服务器上时序问题会暴露。确保用await等待Excel的writeFile或buffer操作完成：

  await workbook.xlsx.writeFile('./temp/data.xlsx');
  // 待文件生成后再执行邮件发送逻辑
  

• 错误捕获缺失：代码若未添加try/catch，服务器端的错误会被静默吞掉，无法排查。在数据库查询、文件生成、邮件发送等关键逻辑外包裹try/catch并打印错误日志：

  try {
    const data = await db.query('SELECT * FROM target_table');
    const workbook = new ExcelJS.Workbook();
    // 填充Excel数据逻辑
    await workbook.xlsx.writeFile('./temp/data.xlsx');
    await transporter.sendMail(mailOptions);
  } catch (err) {
    console.error('执行异常:', err);
    // 可添加告警通知逻辑
  }
  

5. 环境依赖问题 #

• Node.js版本差异：本地与服务器的Node.js版本不一致，可能导致ExcelJS或Nodemailer的API兼容问题。检查服务器Node版本，尽量与本地保持一致，或查阅依赖包文档确认兼容版本范围。
• 依赖安装问题：服务器上node_modules可能未正确安装，存在缓存或缺失包。可删除node_modules和package-lock.json，重新执行npm install确保依赖完整。

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