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 でボタンを無効にし、二重送信を防いでいます。
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 のリダイレクトが入ります。
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 で入力欄と結び付けています。
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 のスクリプトは、ページを開いた時点ではなく、初めて送信するときに読み込みます。フォームを使わない人には読み込みの負担がかかりません。サイトキーが無いときはトークンを付けずに送ります。
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 も依存から外せました。
// 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 の不一致など原因を調べやすくなります。
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 に入力されたメールアドレスを入れます。件名に改行が入るとメールのヘッダーが崩れるおそれがあるので、名前の改行は空白に置き換えています。
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 で出力させています。
// 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 にしておく
