常见错误
先打开收件箱,确认消息是否已经保存。已保存但没有邮件时,只排查通知;没有保存记录时,再检查浏览器请求、来源和表单状态。
点击提交没有反应
打开浏览器开发者工具的 Network(网络)面板,再点击提交。没有发往 /f/表单id 的 POST 请求时,检查浏览器必填校验、按钮是否可用,以及 Console 中的脚本错误。确认 AI 改动已经发布到你正在访问的页面;如果直接用 file:// 打开文件,请改用本地 Web 服务器。修正后再次提交,并在收件箱确认保存。
CORS 或网络错误
浏览器可能隐藏未获允许来源的响应。核对当前页面的协议、主机名和端口,并与“网站 → 设置 → 允许的来源”完全匹配。不要用 mode: no-cors 绕过:它会让页面无法读取保存结果。修正后重新从获准页面提交同一条消息。
无法确认是否保存
网络中断不代表服务端一定没有保存。先看收件箱;需要重试时保留原内容和相同 _intent_id,开启防护时取得新的 Turnstile 令牌。只有响应 saved: true 才显示保存成功。不要自动换 intent 后再次发送同一条消息。
409 conflict:修改后重试出现冲突
同一个 _intent_id 代表同一条消息,不能用于不同内容。恢复原内容可重试或回放已有结果;确实要发送新内容时,让访客明确选择“新消息”,再生成新 intent。不要通过静默更换 intent 来掩盖冲突。
字段缺失、附件或内容过大
每个要保存的控件都需要 name。复选框组和多选值需要使用独立字段名或明确转换为字符串;不支持数组或对象值。413 too_large 表示请求过大;415 unsupported 通常是用了 multipart、附件或不支持的编码。请使用 JSON 或 URL 编码的字符串字段。
来源不匹配
当提交因为来源被拒绝时,表单页面会显示 最近有来源不匹配 提示,并给出被拒绝的确切地址。请与 网站 → 你的网站 → 设置 → 允许的来源 对比:协议、主机名和端口必须完全一致,预览子域名与主域名是不同的来源。修正列表并保存,然后从允许的页面重新发送测试。
表单不存在——提交返回 404
提交地址没有匹配到有效表单。请从表单页面重新复制端点:它看起来像 https://formpostbox.com/f/7f3c5b12-6db4-4f9a-91cb-7f5c5b7f8a31,每个表单都有自己的 id。检查是否替换了 YOUR_FORM_ID、是否额外附加了路径,以及删除并重建表单后是否重新复制了代码。
表单已暂停,或防护未配置
打开表单阅读配置检查面板。状态为 已暂停:在表单列表中点击 启用表单即可重新接受提交。Turnstile 未配置:如果你有意不启用防护,这是正常状态;希望开启时,再到 网站 → 垃圾信息防护 中保存密钥。仅在开启邮件通知时:通知地址未验证或已被阻止,在通知地址页面验证一个地址,然后在表单设置中选中它。
消息未保存——密钥或配置问题
如果你选择开启防护,请打开 网站 → 你的网站 → 设置 → 垃圾信息防护:那里显示的站点密钥必须与表单代码中的一致;私密密钥是只写字段,如果不确定,请从 Cloudflare 重新填写。两个密钥必须来自同一个 widget。然后打开表单检查配置检查面板:开启防护时 Turnstile 应显示 已配置;未开启防护的网站显示 未配置 是正常的。还要确认表单为启用中。仅开启邮件通知时,所选通知地址才需要已验证且未被阻止。补齐缺失项并保存,然后重新发送一条测试。
已达提交上限
工作区已用尽当前 UTC 自然月的额度。侧边栏会显示已用和剩余数字,接近上限时会出现提示条。达到上限后新提交会被拒绝,因此被拒绝的表单不应显示成功。Free 和付费的每月额度在次月第一天 00:00 UTC 重置。已保存的消息及其通知任务不受影响。
Turnstile widget 不显示
检查 Cloudflare widget 的 Settings → Hostname Management 是否包含你正在测试的页面主机名——只填主机名,并且记住添加主机名也会覆盖它的子域名。隐私工具和内容拦截器可能隐藏该 widget:试试禁用扩展的隐私窗口。如果你的网站有内容安全策略(CSP),它必须允许 challenges.cloudflare.com;浏览器控制台会显示被拦截的请求。修正主机名或拦截规则后,重新加载页面。
“请先完成 Turnstile 验证,然后重试。”
本次尝试没有可用的新令牌。完成验证后再提交;令牌有效期为 5 分钟,且每个令牌只能使用一次。失败或过期后,示例会清除令牌并渲染新的验证,请不要复用旧标签页或之前的令牌。如果 widget 看起来正常但保存仍然失败,请确认站点密钥与私密密钥来自同一个 widget。
消息已保存,但收不到邮件
先打开消息的通知时间线。如果显示邮件通知未开启,消息保存正常,不会发送邮件;可以为后续提交开启通知,过去的留言不会补发。
消息已安全保存在收件箱中。打开它并阅读通知时间线:已延迟——等待服务商重试。失败——出现按钮时使用 重试通知;重试不会占用更多提交额度。已退信或已阻止——先在表单设置中选择另一个已验证且未被阻止的通知地址再重试。已送达——服务商已把邮件交给收件方服务器;如果看不到,请检查垃圾邮件文件夹。仅“服务商接受”并不保证进入收件箱。
需要 AI 协助?复制排查提示词。提供脱敏后的错误码、发生时间和页面来源即可,不要发送访客消息、密钥、Cookie 或完整请求正文。
仍需帮助?联系 support@formpostbox.com. 请附上相关文档主题和脱敏后的错误信息,不要发送密钥或访客消息。
浏览全部主题 ↑