React / 系统课时

提交表单数据

提交表单数据

表单与 Server Action 组合后,浏览器可以把字段直接作为 FormData 交给服务器处理。本课完成一条最小但完整的提交链路:定义字段、接收数据、服务端校验、构造业务对象,并通过终端输出验证服务器确实拿到了正确结果。

学习目标

  • 使用 <form action={...}> 把表单提交给 Server Action
  • 正确读取并校验 FormData 中的字符串字段
  • 区分浏览器约束与服务端业务校验的职责

表单数据怎样到达服务器

React 扩展了表单的 action 用法:当 action 接收 Server Action 时,提交表单会触发对应的服务端函数,并把当前表单数据作为 FormData 参数传入。字段是否会被提交,主要取决于表单控件的 name。

表单提交到 Server Action 的处理时序

FormData.get() 的返回值不一定是字符串,也可能是 File 或 null。因此不要直接对结果调用 trim(),先判断类型,再进入业务校验。

完成一次可运行提交

下面把表单和 Server Action 放在同一个 app/contact/page.tsx 中。示例不依赖数据库,而是在服务器完成字段规范化、校验和业务对象创建,再把结果写到服务端终端;真实项目可把最后的日志替换为数据库或内部服务调用。

tsx
import { randomUUID } from 'node:crypto'

function readText(formData: FormData, key: string) {
  const value = formData.get(key)
  return typeof value === 'string' ? value.trim() : ''
}

export default function ContactPage() {
  async function submitContact(formData: FormData) {
    'use server'

    const name = readText(formData, 'name')
    const email = readText(formData, 'email')
    const message = readText(formData, 'message')

    // 浏览器校验可以被绕过,所以服务器必须重新检查关键规则。
    if (!name || !email.includes('@') || message.length < 5) {
      console.log('CONTACT_REJECTED')
      return
    }

    const ticket = {
      id: randomUUID(),
      name,
      email,
      message,
    }

    // 真实项目可在这里替换为数据库写入或内部服务调用。
    console.log('CONTACT_CREATED', ticket)
  }

  return (
    <main>
      <h1>联系表单</h1>
      <form action={submitContact}>
        <input name="name" placeholder="姓名" required />
        <input name="email" type="email" placeholder="邮箱" required />
        <textarea name="message" minLength={5} required />
        <button type="submit">提交</button>
      </form>
    </main>
  )
}

用 Ada、ada@example.com 和 想了解企业版套餐 提交后,服务端终端会出现类似结果。

预期输出

text
CONTACT_CREATED {
  id: '<ID>',
  name: 'Ada',
  email: 'ada@example.com',
  message: '想了解企业版套餐'
}

<ID> 每次提交都会不同。浏览器中的 required、type="email" 和 minLength 提供即时交互约束,但真正决定是否接受数据的仍是 Server Action 里的服务端判断。

服务端为什么还要重新校验

客户端约束只能改善填写体验,不能当成安全规则。请求可以绕过页面直接构造,因此服务器必须重新验证必填字段、格式、长度、用户身份以及“当前用户是否允许执行这次变更”。

另外,字段名属于客户端与服务端之间的协议。页面使用 name="email",服务器就应该明确读取 formData.get('email')。不要把整个 FormData 不加筛选地直接交给 ORM 或数据库层,显式选择允许写入的字段更容易控制边界。

接入真实业务时替换哪一层

当前示例已经把“采集字段 → 服务端读取 → 校验 → 构造业务对象”串通。接入真实项目时,通常只需要把 console.log('CONTACT_CREATED', ticket) 替换为受控的数据写入,同时在操作开始处加入登录态和权限检查。

写入成功后,如果页面展示了受缓存影响的数据,再按需要做缓存失效;如果业务流程应该进入另一个页面,则在成功分支执行服务端跳转。无论后续接数据库还是外部服务,表单本身不应该承担权限判断,可信业务规则始终留在 Server Action 中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提交表单数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通