以systemd服务运行Node应用时，msmtp子进程执行异常问题

核心原因 #

systemd服务的运行环境与普通用户会话存在差异：环境变量（如HOME）可能未正确设置，导致msmtp无法找到配置文件；同时原代码未捕获子进程输出，无法定位具体错误。

解决方案 #

1. 显式指定msmtp配置文件路径 #

修改Node代码中spawn的参数，直接指定.msmtprc的绝对路径，避免路径解析问题，同时添加输出监听排查错误：

try {
  const process = child_process.spawn(
    "msmtp",
    ["-t", "-C", "/home/me/.msmtprc"] // 新增-C参数指定配置文件
  );

  // 新增输出监听，捕获msmtp执行日志
  process.stdout.on('data', (data) => {
    console.log(`msmtp stdout: ${data}`);
  });

  process.stderr.on('data', (data) => {
    console.error(`msmtp stderr: ${data}`);
  });

  process.on('close',', (code) => {
    console.log(`msmtp exited with code ${code}`);
  });

  // 原邮件内容写入逻辑
  process.stdin.write("From: " + returnMail + "\n");
  process.stdin.write("MIME-Version: 1.0\n");
  process.stdin.write("Content-Type: text/html\n");
  process.stdin.write("To: " + recepient + "\n");
  process.stdin.write(
    "Subject: Some Subject\n\n"
  );
  process.stdin.write(`<!DOCTYPE HTML>
<html>
<head><title>Some Subject</title>
<body>
<h1>Something happened</h1>
<h2>Oh No!</h2>
<div>${content}</div>
</body>
</html>`
  );
  process.stdin.end();
} catch (error) {
  console.error(error);
  return;
}

2. 修正systemd服务的环境变量 #

在systemd服务配置文件的[SERVICE]段添加HOME环境变量，明确指定用户主目录：

[SERVICE]
Type=simple
WorkingDirectory=/home/me/app
ExecStart=/usr/bin/npm run start
User=me
Group=me
Restart=always
RestartSec=3
Environment="HOME=/home/me" # 新增该行

修改后重启服务生效：

sudo systemctl daemon-reload
sudo systemctl restart MyApp

3. 验证.msmtprc的权限设置 #

msmtp要求配置文件权限必须为600（仅所有者可读可写），否则会拒绝读取，执行以下命令修复权限：

chmod 600 /home/me/.msmtprc
chown me:me /home/me/.msmtprc

排查说明 #

通过添加子进程的stdout/stderr监听，可获取msmtp的执行日志，常见错误包括：

• 配置文件权限过高被拒绝
• 无法连接邮件服务器（防火墙/网络问题）
• 配置文件中的账户信息错误

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