跳转至

Hapi

适用于 Hapi（Node.js 18+）应用的集成指南。Mailexam 通过 Nodemailer 作为 SMTP 接入 — 无需单独的邮件插件。

前置条件

  • Mailexam 账户，以及已创建并具备 SMTP 凭据的项目。
  • Node.js 18+ 及 npm。

从项目的欢迎邮件（或控制台）中复制：

  • YOUR_LOGIN — SMTP 登录名（例如 xxxxx）；
  • YOUR_PASSWORD — SMTP 密码（与登录名成对的唯一凭据）；
  • 主机 — YOUR_LOGIN.mailexam.cn（与登录名一致）。

1. 依赖

npm init -y
npm install @hapi/hapi nodemailer dotenv

package.json：

{
  "type": "commonjs",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "@hapi/hapi": "^21.0.0",
    "dotenv": "^16.0.0",
    "nodemailer": "^6.9.0"
  }
}

2. 环境变量

项目根目录的 .env 文件（勿将密码提交到 git）：

MAILEXAM_LOGIN=YOUR_LOGIN
MAILEXAM_PASSWORD=YOUR_PASSWORD
MAILEXAM_PORT=587
MAIL_FROM=noreply@example.test

SMTP 主机：YOUR_LOGIN.mailexam.cn。

发件人地址

MAIL_FROM 可以是任意测试地址——邮件进入 Mailexam，而非真实收件人。

备选端口

MAILEXAM_PORT=587

传输配置中：secure: false。

MAILEXAM_PORT=2525

MAILEXAM_PORT=465

传输配置中：secure: true。

3. Nodemailer 传输

// mail.js
const nodemailer = require('nodemailer');

function createTransport() {
  const login = process.env.MAILEXAM_LOGIN;
  const port = Number(process.env.MAILEXAM_PORT || 587);

  return nodemailer.createTransport({
    host: `${login}.mailexam.cn`,
    port,
    secure: port === 465,
    auth: {
      user: login,
      pass: process.env.MAILEXAM_PASSWORD,
    },
  });
}

async function sendTest({ to, subject, text }) {
  const transport = createTransport();

  await transport.sendMail({
    from: process.env.MAIL_FROM || 'noreply@example.test',
    to: to || 'user@example.test',
    subject: subject || 'Hapi + Mailexam',
    text: text || '来自 Hapi 的 Mailexam 测试',
  });
}

module.exports = { sendTest };

4. Hapi 路由

// server.js
require('dotenv').config();

const Hapi = require('@hapi/hapi');
const { sendTest } = require('./mail');

async function init() {
  const server = Hapi.server({
    port: 3000,
    host: '127.0.0.1',
  });

  server.route({
    method: 'POST',
    path: '/mail/test',
    options: {
      payload: {
        parse: true,
        allow: 'application/json',
      },
    },
    handler: async (request) => {
      const { to, subject, text } = request.payload || {};

      await sendTest({ to, subject, text });

      return { status: 'ok' };
    },
  });

  await server.start();
  console.log('Server running on %s', server.info.uri);
}

init().catch((err) => {
  console.error(err);
  process.exit(1);
});

启动并验证：

npm start

curl -X POST http://127.0.0.1:3000/mail/test \
  -H 'Content-Type: application/json' \
  -d '{"to":"user@example.test","subject":"测试","text":"你好"}'

邮件将出现在 Mailexam 控制台 → 您的项目 → 收件箱。

5. 本地开发与 CI

环境 建议
local .env + require('dotenv').config()
CI GitLab CI/CD Variables 中的密钥 MAILEXAM_LOGIN、MAILEXAM_PASSWORD

.gitlab-ci.yml 示例：

variables:
  MAILEXAM_LOGIN: $MAILEXAM_LOGIN
  MAILEXAM_PASSWORD: $MAILEXAM_PASSWORD
  MAILEXAM_PORT: "587"
  MAIL_FROM: "noreply@example.test"

单元测试可 mock sendTest，或单独使用 Nodemailer 测试账户（与 Mailexam 无关）。

集成测试后，通过 Mailexam API 验证投递。

6. 常见问题

连接超时 / 认证失败

  • host 须为 {login}.mailexam.cn，auth.user — 邮件中的同一登录名。
  • 登录名和密码为同一项目的邮件成对凭据。

587 端口与 TLS

  • 587：secure: false（STARTTLS）。465：secure: true。

payload 为空

  • 确保 payload.parse: true，并设置 Content-Type: application/json 头。

控制台中看不到邮件

  • 查看同一 Mailexam 项目的收件箱。
  • sendMail 失败时 SMTP 错误会输出到 Node 控制台。

参见