本文へ移動
← Archive No.12 / 15 Gatsby →
Gatsby

静的なGatsbyサイトにVercel Functionsでお問い合わせフォームを付ける

Gatsby

Gatsby で作った静的サイトでも、Vercel にデプロイするなら api/ フォルダに関数を置くだけでサーバー処理を追加できます。「Gatsby Base」のお問い合わせフォームは、この方法で Gmail にメールを送っています。React 19 と Web 標準の Request/Response に合わせて書き直したので、その内容を紹介します。

リポジトリ:Gatsby-TypeScript-Threejs-MicroCMS-Site / デモ:https://gatsbybase.vercel.app/

構成

  • フロント:src/components/Contact.tsx(React 19 の useActionState)
  • サーバー:api/contact.ts(Vercel Function、Web 標準の Request/Response)
  • 送信:Nodemailer + Gmail の SMTP
  • スパム対策:reCAPTCHA v3(任意。初めて送信するときに読み込む)

フォームは useActionState で

React 19 では、<form action={…}> に関数を渡せます。useActionState を使うと、送信の処理・結果の状態・送信中かどうかを 1 つのフックで扱えます。送信中は pending でボタンを無効にし、二重送信を防いでいます。

tsx
async function send(_: State, formData: FormData): Promise<State> {
  const values = Object.fromEntries(
    fields.map((f) => [f, String(formData.get(f) ?? "").trim()]),
  ) as Values;
  const errors: Errors = {};
  for (const f of fields) {
    const msg = rules[f](values[f]);
    if (msg) errors[f] = msg;
  }
  if (Object.keys(errors).length) return { status: "invalid", values, errors };

  try {
    const res = await fetch("/api/contact/", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ ...values, googleReCaptchaToken: await getToken() }),
    });
    if (!res.ok) throw new Error(String(res.status));
    return { status: "success", values: empty, errors: {} };
  } catch {
    return { status: "error", values, errors: {} };
  }
}

const [state, formAction, pending] = useActionState(send, { status: "idle", values: empty, errors: {} });

注意点が 2 つあります。

  • React は送信後にフォームをリセットします。入力ミスで送れなかったときに内容が消えないよう、送った値を状態に入れて返し、各入力欄の defaultValue に戻しています。
  • 送信先は末尾にスラッシュを付けた /api/contact/ にしています。このサイトでは Vercel が URL の末尾にスラッシュを付けるため、付けずに送ると 308 のリダイレクトが入ります。
tsx
const control = (name: Field) => ({
  id: name,
  name,
  placeholder: " ",
  defaultValue: state.values[name],
  onBlur: check,
  "aria-invalid": Boolean(errors[name]) || undefined,
  "aria-describedby": `err-${name}`,
});

入力チェックとフォーカス

入力欄を離れたとき(onBlur)と送信したときの 2 回チェックします。送信時にエラーがあれば、useEffect で最初のエラー項目にフォーカスを移すので、キーボードで操作している人もどこを直せばいいかすぐ分かります。エラー文は aria-describedby で入力欄と結び付けています。

tsx
useEffect(() => {
  setBlurErrors({});
  if (state.status !== "invalid") return;
  const first = fields.find((f) => state.errors[f]);
  if (first) form.current?.querySelector<HTMLElement>(`[name="${first}"]`)?.focus();
}, [state]);

reCAPTCHA は送信するときに読み込む

reCAPTCHA のスクリプトは、ページを開いた時点ではなく、初めて送信するときに読み込みます。フォームを使わない人には読み込みの負担がかかりません。サイトキーが無いときはトークンを付けずに送ります。

ts
const getToken = (): Promise<string | undefined> => {
  if (!SITE_KEY) return Promise.resolve(undefined);
  return new Promise((resolve) => {
    const run = () =>
      window.grecaptcha!.ready(() =>
        window.grecaptcha!.execute(SITE_KEY, { action: "submit" }).then(resolve, () => resolve(undefined)),
      );
    if (window.grecaptcha) return run();
    const script = document.createElement("script");
    script.src = `https://www.google.com/recaptcha/api.js?render=${SITE_KEY}`;
    script.onload = run;
    script.onerror = () => resolve(undefined);
    document.head.append(script);
  });
};

Vercel Function は Web 標準の Request/Response で

以前は @vercel/node の VercelRequest/VercelResponse を使っていました。今は HTTP メソッドの名前で関数を export し、Web 標準の Request を受け取って Response を返す形にしています。POST だけを export すれば、ほかのメソッドには自動で 405 が返るので、メソッドの判定を書く必要がありません。@vercel/node も依存から外せました。

ts
// api/contact.ts
const error = (status: number, message: string) =>
  Response.json({ error: message }, { status });

export async function POST(request: Request) {
  const body: ContactBody = await request.json().catch(() => ({}));
  const name = body.name?.trim();
  const email = body.email?.trim();
  const message = body.message?.trim();

  if (!name || !email || !message) return error(400, "Missing required fields");
  if (!EMAIL.test(email)) return error(400, "Invalid email");

  const { RECAPTCHA_SECRET_KEY, SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, CONTACT_TO_EMAIL } = process.env;

  // 設定漏れは、どの変数が足りないかをログに出して 500 を返す
  if (!SMTP_USER || !SMTP_PASS || !CONTACT_TO_EMAIL) {
    const missing = ["SMTP_USER", "SMTP_PASS", "CONTACT_TO_EMAIL"].filter((k) => !process.env[k]);
    console.error(`Missing env: ${missing.join(", ")}`);
    return error(500, "Mail is not configured");
  }

  if (RECAPTCHA_SECRET_KEY) {
    const token = body.googleReCaptchaToken;
    if (!token || !(await verifyRecaptcha(RECAPTCHA_SECRET_KEY, token))) {
      return error(403, "reCAPTCHA verification failed");
    }
  }
  // Nodemailer で送信(後述)
  return Response.json({ ok: true });
}

JSON として読めない本文が来ても例外で落ちないよう、request.json() には .catch(() => ({})) を付けています。ブラウザ側の入力チェックは送信前の案内にすぎないので、サーバー側でも必須項目とメールアドレスの形式を確かめます。

reCAPTCHA v3 はスコアと action も見る

検証 API の success だけを見ると、スコアが低い送信も通ってしまいます。送信時に指定した action が submit であることと、score が 0.5 以上であることも確認します。失敗したときはレスポンス全体をログに出しておくと、hostname の不一致など原因を調べやすくなります。

ts
const verifyRecaptcha = async (secret: string, token: string) => {
  const res = await fetch("https://www.google.com/recaptcha/api/siteverify", {
    method: "POST",
    body: new URLSearchParams({ secret, response: token }),
  });
  const result: { success: boolean; score?: number; action?: string } = await res.json();
  const ok = result.success && result.action === "submit" && (result.score ?? 0) >= 0.5;
  if (!ok) console.warn(`reCAPTCHA verification failed: ${JSON.stringify(result)}`);
  return ok;
};

Nodemailer で送信

返信ボタンで問い合わせた人に直接返せるよう、replyTo に入力されたメールアドレスを入れます。件名に改行が入るとメールのヘッダーが崩れるおそれがあるので、名前の改行は空白に置き換えています。

ts
const port = Number(SMTP_PORT || 465);
const transporter = nodemailer.createTransport({
  host: SMTP_HOST || "smtp.gmail.com",
  port,
  secure: port === 465,
  auth: { user: SMTP_USER, pass: SMTP_PASS },
});

try {
  await transporter.sendMail({
    from: SMTP_USER,
    to: CONTACT_TO_EMAIL,
    replyTo: email,
    subject: `【Gatsby Base】お問い合わせ: ${name.replace(/[\r\n]/g, " ")}`,
    text: `お名前: ${name}\nメールアドレス: ${email}\n\nメッセージ:\n${message}`,
  });
} catch (err) {
  console.error("Failed to send contact mail", err);
  return error(500, "Failed to send mail");
}

api/ だけ CommonJS で出力する

Vercel は api/ の TypeScript を、いちばん近い tsconfig.json の設定でコンパイルします。このプロジェクトの package.json には "type": "module" が無いので、ルートの設定どおり ESM で出力すると、関数の読み込み時に FUNCTION_INVOCATION_FAILED で落ちます。そこで api/tsconfig.json を置き、関数だけ CommonJS で出力させています。

json
// api/tsconfig.json
{
  "compilerOptions": {
    "target": "es2023",
    "module": "commonjs",
    "lib": ["es2023", "dom"],
    "types": ["node"],
    "esModuleInterop": true,
    "strict": true,
    "skipLibCheck": true
  },
  "include": ["./**/*.ts"]
}

また、TypeScript は 6.x に固定しています。Vercel は api/ のコンパイルに、プロジェクトの typescript パッケージの JavaScript API(readConfigFile や transpileModule)を使います。ネイティブ版の TypeScript 7 にはこの API が無いためです。

環境変数

変数

用途

CONTACT_TO_EMAIL

受信先(必須)

SMTP_USER / SMTP_PASS

送信に使う Gmail とアプリパスワード(必須)

SMTP_HOST / SMTP_PORT

既定値は smtp.gmail.com / 465

RECAPTCHA_SECRET_KEY

サーバー側の検証(未設定なら検証しない)

GATSBY_RECAPTCHA_SITE_KEY

ブラウザ側のサイトキー

Gatsby では GATSBY_ で始まる環境変数だけがブラウザのコードに埋め込まれます。シークレットキーにはこの接頭辞を付けないでください。reCAPTCHA を使う場合は、2 つのキーを必ずセットで設定します。シークレットキーだけを設定すると、ブラウザからトークンが送られないので、すべての送信が 403 で拒否されます。

まとめ

  • フォームは useActionState で、送った値を返して入力内容を残す
  • Vercel Function は POST を export し、Web 標準の Request/Response で書く
  • 設定漏れはどの変数が足りないかをログに出す
  • reCAPTCHA は送信時に読み込み、スコアと action も確認する
  • api/ は CommonJS で出力し、TypeScript は 6.x にしておく