React / 系统课时
提交表单数据
提交表单数据
表单与 Server Action 组合后,浏览器可以把字段直接作为 FormData 交给服务器处理。本课完成一条最小但完整的提交链路:定义字段、接收数据、服务端校验、构造业务对象,并通过终端输出验证服务器确实拿到了正确结果。
学习目标
- 使用
<form action={...}>把表单提交给 Server Action - 正确读取并校验
FormData中的字符串字段 - 区分浏览器约束与服务端业务校验的职责
表单数据怎样到达服务器
React 扩展了表单的 action 用法:当 action 接收 Server Action 时,提交表单会触发对应的服务端函数,并把当前表单数据作为 FormData 参数传入。字段是否会被提交,主要取决于表单控件的 name。

FormData.get() 的返回值不一定是字符串,也可能是 File 或 null。因此不要直接对结果调用 trim(),先判断类型,再进入业务校验。
完成一次可运行提交
下面把表单和 Server Action 放在同一个 app/contact/page.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 和 想了解企业版套餐 提交后,服务端终端会出现类似结果。
预期输出
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 中。