← 返回 线条风格的浏览器窗口,展示简单表单和一个箭头指向打开的信封在邮件托盘中

2026年Netlify Forms指南:设置、垃圾邮件过滤和限制

工具与厂商对比

Netlify Forms通过在部署时读取已构建的HTML来工作。开启表单检测,在表单标签上添加netlify或data-netlify="true"属性,给表单一个唯一的名称,然后重新部署。这对于普通HTML网站来说已经足够了。Astro、Next.js和任何由JavaScript呈现的内容需要表单的静态HTML副本,因为构建过程永远看不到真正的表单。以下是每种情况的设置、Akismet过滤加蜜罐和reCAPTCHA、通知、Netlify自己的页面对限制的说明、故障排除表和何时应该选择其他后端。

Netlify Forms如何工作

无需构建表单端点。部署完成后,Netlify的构建系统解析即将发布的HTML。根据Netlify表单设置文档,这是为什么页面不需要API调用和额外JavaScript的原因。

三个条件必须满足:

  • 网站启用了表单检测(在Netlify UI中,转到Forms并选择Enable form detection)。从下一次部署开始生效。
  • 表单标签携带data-netlify="true"或bare netlify属性。
  • 表单有一个名称,网站上没有其他表单共享它。

在解析期间,构建会移除data-netlify或netlify属性,并注入一个名为form-name的隐藏输入,其值与表单名称匹配。提交内容随后会出现在Netlify UI的Forms部分。Akismet通过的任何内容都进入Verified submissions;它标记的任何内容都进入Spam submissions。

有一个陷阱值得提前了解:如果你曾经禁用了检测,重新启用它,转到Forms,然后Form detection,在你重新部署之前什么都不会发生。同一份文档指出,禁用检测会减少后处理,可能会加快部署速度,这是在不再有表单的网站上关闭它的充分理由。

普通HTML、Astro和Next.js的设置

普通HTML

这是我对静态网站会逐项检查的清单:

  1. 在Netlify UI中,打开Forms并选择Enable form detection。
  2. 将data-netlify="true"或netlify添加到表单标签。
  3. 在表单上设置一个唯一的name,在每个输入上设置一个不同的name。
  4. 部署。如果检测已经开启,你只添加了表单,正常部署就足够了;如果你刚刚开启它,则重新部署。
  5. 发送一个真实的测试条目,在Verified submissions下查看,然后在Spam submissions下查看。

文档自己的例子是一个contact表单,包含method="POST"、name、email、多选和消息。没有什么奇异的,也没有超出模式所需的内容。

如果你想用fetch提交,body必须是URL编码的。文档用new URLSearchParams(formData).toString()和application/x-www-form-urlencoded标头构建它。Netlify Forms目前不支持JSON表单数据,所以JSON.stringify是死路一条。对于文件上传,文档建议不带Content-Type标头。

Astro

Netlify的Astro模板将netlify属性直接放在表单标签上,并添加netlify-honeypot用于垃圾邮件阻止。这是简单的版本,也是一个很好的起点。

但Netlify的知识库文章(日期为2026年8月27日)将Astro与Next.js、Nuxt、SvelteKit和Gatsby并列,作为表单"不在构建的HTML中,因此部署时解析永远看不到它们"的框架。它的修复方法是在public/__forms.html保留每个表单的隐藏副本,字段名称必须完全匹配。如果你的Astro表单从未出现在UI中,添加该骨架文件并重新部署。

Next.js

这是大多数人浪费一个下午的地方。OpenNext 的 Netlify 文档解释说,现代 Next.js 页面是预渲染和缓存的,而不是作为静态 HTML 文件写出的。因此 netlify 或 data-netlify 属性在你的 React 代码中没有效果,表单的目标 URL 必须是一个静态文件。

解决方法在 Netlify 的页面中始终一致:

  • 在 public 文件夹中放一个静态 HTML 文件,定义表单和每个字段,名称与你的 React 表单匹配。
  • 使用 AJAX 提交到该静态目标,而不是完整页面导航(故障排除提示说 Next.js Runtime v5 需要在专用静态 HTML 文件中定义表单并通过 AJAX 提交)。
  • 在你的 React 表单中包含隐藏的 form-name 输入。

OpenNext 还提到,通过将 NETLIFY_NEXT_VERIFY_FORMS 设置为 false 可以跳过适配器的表单检查。对于 Next.js 13.5 及更高版本,设置文档指向运行时的 v5 破坏性更改。

任何 JavaScript 渲染的表单

四处都是同样的想法。构建"在预构建文件中找不到它",所以创建一个隐藏的 HTML 表单,名称属性匹配,并向 JS 表单添加隐藏的 form-name 输入。还想要 reCAPTCHA 2?隐藏的 HTML 还需要一个 data-netlify-recaptcha="true" 的 div。

一个老实的皱折:设置文档的 AJAX 示例发送到 /,而知识库示例发送到 /__forms.html,并说静态网站可以 POST 到 /,但 SSR 必须针对骨架文件。如果在 SSR 网站上发送到 / 返回 404,请尝试骨架路径。

垃圾邮件:蜜罐、reCAPTCHA 和 Akismet

每次提交都会通过 Akismet,根据垃圾邮件过滤文档。你不需要配置就能获得这个。额外的功能是可选的,它们的行为不同。

线条艺术筛网捕捉小型虫子形机器人,同时信封通过,旁边是一个带虚线隐藏字段的表单。

蜜罐

将 netlify-honeypot="bot-field"(或任何名称)添加到表单标签,然后包含一个具有该名称的输入,并使用 CSS 或 JavaScript 隐藏它。构建会删除该属性并保留输入。如果机器人填充它,Netlify 会悄悄拒绝提交。

两个细节会造成咬人。使用 CSS 隐藏它,而不是将 type="hidden" 视为足够,因为想法是一个字段机器人看到而人类看不到。使用 AJAX,蜜罐字段名称必须在 POST 正文中,如果你使用 FormData() 编码,这会自动发生。故障排除常见问题补充说,蜜罐从提交中省略或填充会被悄悄拒绝。手动构建的跳过该字段的请求体将消失。

reCAPTCHA 2

Netlify 可以提供一个:将 data-netlify-recaptcha="true" 添加到表单标签和应该出现验证的空 div。验证是服务器端的,失败会将访问者重定向回同一页面并拒绝提交。你每页获得一个 Netlify 提供的验证。

需要多个,还是想要控制?使用自定义 reCAPTCHA 2。设置 SITE_RECAPTCHA_KEY(范围必须包括 Builds 和 Runtime)和 SITE_RECAPTCHA_SECRET(范围必须包括 Runtime),Netlify 只接受带有有效 g-recaptcha-response 的提交。

什么去往哪里

这是人们遗漏的部分。由蜜罐或 reCAPTCHA 2 捕获的提交会被直接拒绝,永远不会到达你的垃圾邮件提交列表。如果真正的人报告发送失败,你无法从该标签中挖出它。相比之下,Akismet 捕获的内容会被保留以供审查。

通知和集成

通知位于 Forms,然后是 Submission notifications。设置文档描述了两条路线:将提交内容发送到电子邮件地址,或使用 HTTP POST 请求将其发送到外部服务。

第二条路线是灵活的。将其指向 webhook,你可以馈送 Slack、CRM 或你自己的端点。来自 Static Forms 的第三方比较将 Netlify Forms 集成列为电子邮件、webhook 和 Slack,这符合这个图景。这是竞争对手的页面,所以将其理解为摘要,而不是规范。

来自知识库的一个小提示:包含一个 <input name="email"> 并且通知电子邮件的"回复到"设置为提交者。点击"回复"然后去访问者而不是 Netlify。

如果你的表单接受上传,记住限制:每个字段一个文件,8 MB 的最大表单请求大小,和 30 秒的超时。如果这些文件包含个人数据,Netlify 说你需要额外的安全配置,并建议使用其 Very Good Security 集成。

限制和定价

简短版本:查看 Netlify 的页面时请按照你决定的那一天的内容读取,因为他们目前的说法并不完全一致。

定价页面列出免费版永久$0(每月300积分限额)、个人版$9/月(1,000积分)和专业版$20/月(无限成员,起始3,000积分,分层最高达20,000积分)。它描述包含的积分涵盖生产部署、计算、表单提交、带宽和网络请求。常见问题补充说,2025年9月4日之前创建的账户可以保留其当前计划。

表单使用和计费文档说基于积分的计划中,表单免费且无限制。一个页面列出表单提交属于积分覆盖的内容,而另一个说这些计划中表单不收费。第三方文章也有分歧:splitforms.com 评测说自2026年4月14日起提交不消耗积分,而 Submit JSON 对比说它们消耗积分。我会比起两者都更相信 Netlify 的计费文档,然后在你自己的仪表盘中确认。

在旧版计划上,文档说表单使用跟踪提交(计费周期内已验证提交)和文件上传(总存储),按网站计量。达到等级限制时,网站自动升级到下一等级或套餐,免费层账户也有计量限制。我见到的唯一数字,即每个网站每月100次提交,来自 splitforms.com 评测而非 Netlify 的页面。依赖它之前请检查。

定价页面和计费文档都没有标注日期,所以在你阅读时打开两者。

故障排除表

下面的修复来自 Netlify 的故障排除常见问题(2026年10月3日)和表单故障排除建议(2026年9月16日),加上设置文档。

症状原因修复
表单从未在 Netlify 用户界面中出现客户端渲染,或检测已关闭添加名称匹配的静态 HTML 副本;启用检测并重新部署
新字段在提交中缺失字段不在静态 HTML 版本中将字段添加到静态表单并重新部署
启用检测后没有任何反应仅适用于新部署重新部署网站
测试条目不在已验证提交中Akismet 将其标记为垃圾检查垃圾提交;使用真实邮箱、完整句子并间隔测试
使用蜜罐时提交消失蜜罐字段被省略或被填充在 POST 正文中包含该字段;使用 FormData()
AJAX 发送失败或被忽略以 JSON 格式发送请求体对请求体进行 URL 编码
Next.js 属性无作用页面不是静态 HTML 文件public 文件夹中的静态表单,通过 AJAX 提交
重命名字段后旧数据消失UI 仅显示当前字段使用 API 的 listFormSubmissions 端点;隐藏旧字段而不是删除它们

如果表单无声地什么都不做,按顺序检查前三行。这涵盖了大多数情况。

何时采用不同的后端更合适

当你已经在 Netlify 上并需要一个联系表单时,Netlify Forms 是个不错的默认选择。但不总是正确的。

坚持使用 WordPress

如果你的网站是 WordPress 并且表单已经能正常工作,就很少有理由迁移它。Contact Form 7、WPForms 等类似的插件运行在你自己的服务器上,数据保存在你自己的数据库中,并且集成在你团队已经熟悉的编辑器里。如果邮件没有送达,那是一个投递问题,你可以在原地解决:参考Contact Form 7 停止发送邮件的原因。只有在整个网站也迁移到静态构建时,才值得把表单移到 Netlify。那是一个托管决策,Vercel 对比 Netlify是权衡的好地方。

Formspree 和类似的表单后端

如果你的网站不是通过 Netlify 的构建部署的,托管的表单后端就有意义。Netlify Forms 依赖于部署时检测,所以只适用于部署在那里的网站。表单服务给你一个从任何主机都能工作的端点。例如,Static Forms 的比较页面列出了免费层为每 30 天 250 次提交,这是它自己的数字,在它自己的页面上。Formspree 原理相同,不过我这里不引用它的限制。查看它的定价页面。

无服务器函数

如果你需要针对数据库进行验证、发送自定义邮件或调用其他 API,函数给你完全的控制权,成本就是你维护的代码。Netlify 的 Astro 模板在其资源中指向表单触发的函数,这为你提供了一条中间路径:保留 Netlify Forms 用于存储和反垃圾,并为每次提交运行代码。

CMS 或页面构建器表单

如果编辑需要在不接触代码的情况下改变字段,内置在 CMS 或页面构建器中的表单就能胜出。静态 HTML 蓝图文件的编辑友好度最低。

FAQ

我能在托管在其他地方的网站上使用 Netlify Forms 吗?

不能按你期望的方式使用。检测发生在 Netlify 的构建中,所以表单必须在 Netlify 部署中。第三方评测说法相同:表单可在部署到 Netlify 的网站上工作。

为什么回复会发到错误的地址?

在表单中添加 <input name="email">。知识库说那样可以将通知邮件的"回复至"设置为提交者。

如果我删除表单,应该关闭表单检测吗?

这是合理的。Netlify 说禁用它可以减少后处理,可能会加快部署速度。你通过输入站点名称来确认,从下次部署开始生效。

我可以收集包含个人数据的文件吗?

Netlify 说包含 PII 的上传表单需要额外的安全配置,并推荐 Very Good Security 集成。还要记住单文件字段和 8 MB 请求限制。

最尖锐的警告:Netlify 只能看到部署时以静态 HTML 形式存在的表单,所以任何框架渲染的表单都需要一个字段名匹配的静态副本。如果你在考虑迁移到静态栈,想要对构建有第二意见,Jamstack 开发服务涵盖了这类工作。

← 返回