{"id":253,"date":"2026-09-14T10:20:37","date_gmt":"2026-09-14T02:20:37","guid":{"rendered":"https:\/\/yykcj.com\/?p=253"},"modified":"2026-09-14T10:20:37","modified_gmt":"2026-09-14T02:20:37","slug":"react-server-actions-%e5%85%a5%e9%97%a8%e4%b8%8e%e8%bf%9b%e9%98%b6%ef%bc%9a%e4%bb%8e%e8%a1%a8%e5%8d%95%e6%8f%90%e4%ba%a4%e5%88%b0%e5%85%a8%e6%a0%88%e6%95%b0%e6%8d%ae%e6%b5%81","status":"publish","type":"post","link":"https:\/\/yykcj.com\/?p=253","title":{"rendered":"React Server Actions \u5165\u95e8\u4e0e\u8fdb\u9636\uff1a\u4ece\u8868\u5355\u63d0\u4ea4\u5230\u5168\u6808\u6570\u636e\u6d41"},"content":{"rendered":"

\u4e3a\u4ec0\u4e48\u9700\u8981 Server Actions\uff1f<\/h2>\n

\u5728\u4f20\u7edf\u7684 React \u5168\u6808\u5f00\u53d1\u4e2d\uff0c\u6211\u4eec\u901a\u5e38\u9700\u8981\uff1a<\/p>\n

    \n
  1. \u521b\u5efa\u4e00\u4e2a API \u8def\u7531\uff08\u5982 \/api\/submit<\/code>\uff09<\/li>\n
  2. \u5728\u524d\u7aef\u7528 fetch<\/code> \u8c03\u7528\u8be5\u63a5\u53e3<\/li>\n
  3. \u624b\u52a8\u5904\u7406 loading\u3001\u9519\u8bef\u548c\u91cd\u65b0\u9a8c\u8bc1<\/li>\n<\/ol>\n

    \u8fd9\u79cd\u6a21\u5f0f\u4ee3\u7801\u5206\u6563\u3001\u6837\u677f\u4ee3\u7801\u591a\uff0c\u4e14\u5bb9\u6613\u9057\u6f0f\u52a0\u8f7d\u72b6\u6001\u3002React Server Actions\uff08\u4ee5\u4e0b\u7b80\u79f0 Server Actions\uff09\u5141\u8bb8\u4f60\u5728\u7ec4\u4ef6\u4e2d\u76f4\u63a5\u5b9a\u4e49\u5f02\u6b65\u670d\u52a1\u7aef\u51fd\u6570<\/strong>\uff0c\u5e76\u901a\u8fc7\u8868\u5355\u6216\u4e8b\u4ef6\u8c03\u7528\u5b83\u4eec\uff0c\u4ece\u800c\u7b80\u5316\u6570\u636e\u53d8\u66f4\u6d41\u7a0b\u3002<\/p>\n

    Server Actions \u662f React 19 \u7684\u7a33\u5b9a\u7279\u6027\uff0cNext.js 13.4+ \u5df2\u5185\u7f6e\u652f\u6301\u3002\u672c\u6587\u5c06\u57fa\u4e8e Next.js 14\uff08App Router\uff09\u8fdb\u884c\u6f14\u793a\uff0c\u4f46\u6838\u5fc3\u6982\u5ff5\u540c\u6837\u9002\u7528\u4e8e\u5176\u4ed6\u652f\u6301 React Server Components \u7684\u6846\u67b6\u3002<\/p>\n

    \u73af\u5883\u51c6\u5907<\/h2>\n

    \u786e\u4fdd\u4f60\u5df2\u5b89\u88c5 Node.js 18.17 \u6216\u66f4\u9ad8\u7248\u672c\u3002\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 Next.js \u9879\u76ee\uff1a<\/p>\n

    \nnpx create-next-app@latest server-actions-demo --typescript --app --tailwind --eslint\ncd server-actions-demo\n<\/code><\/pre>\n
    \u5b89\u88c5\u5fc5\u8981\u4f9d\u8d56\uff08\u672c\u6587\u4f1a\u7528\u5230 zod<\/code> \u505a\u6570\u636e\u9a8c\u8bc1\uff09\uff1a<\/p>\n
    \nnpm install zod\n<\/code><\/pre>\n
    \u542f\u52a8\u5f00\u53d1\u670d\u52a1\u5668\uff1a<\/p>\n
    \nnpm run dev\n<\/code><\/pre>\n
    \u7b2c\u4e00\u6b65\uff1a\u5b9a\u4e49\u4e00\u4e2a\u6700\u7b80\u5355\u7684 Server Action<\/h2>\n
    \u5728 app\/actions.ts<\/code> \u4e2d\u521b\u5efa\u4e00\u4e2a Server Action\uff1a<\/p>\n
    \n\/\/ app\/actions.ts\n'use server';\n\nexport async function greet(name: string) {\n  \/\/ \u6a21\u62df\u5f02\u6b65\u64cd\u4f5c\n  await new Promise((resolve) => setTimeout(resolve, 500));\n  return `\u4f60\u597d\uff0c${name}\uff01`;\n}\n<\/code><\/pre>\n
    'use server'<\/code> \u6307\u4ee4\u544a\u8bc9 React \u8fd9\u4e2a\u6a21\u5757\u4e2d\u7684\u6240\u6709\u5bfc\u51fa\u51fd\u6570\u90fd\u662f Server Actions\uff0c\u5b83\u4eec\u53ea\u80fd\u5728\u670d\u52a1\u7aef\u6267\u884c\u3002<\/p>\n
    \u5728\u5ba2\u6237\u7aef\u7ec4\u4ef6\u4e2d\u8c03\u7528\u5b83\uff1a<\/p>\n
    \n\/\/ app\/components\/GreetForm.tsx\n'use client';\n\nimport { useState } from 'react';\nimport { greet } from '..\/actions';\n\nexport default function GreetForm() {\n  const [message, setMessage] = useState('');\n\n  async function handleSubmit(formData: FormData) {\n    const name = formData.get('name') as string;\n    const result = await greet(name);\n    setMessage(result);\n  }\n\n  return (\n    <form action={handleSubmit}>\n      <input name="name" placeholder="\u8f93\u5165\u4f60\u7684\u540d\u5b57" required \/>\n      <button type="submit">\u6253\u62db\u547c<\/button>\n      {message && <p>{message}<\/p>}\n    <\/form>\n  );\n}\n<\/code><\/pre>\n
    \u6ce8\u610f\uff1a<\/p>\n
    <\/code> \u662f React 19 \u7684\u65b0\u7279\u6027\uff0c\u5b83\u63a5\u53d7\u4e00\u4e2a\u51fd\u6570\uff08\u53ef\u4ee5\u662f Server Action \u6216\u5ba2\u6237\u7aef\u51fd\u6570\uff09\u3002\u5f53\u8868\u5355\u63d0\u4ea4\u65f6\uff0cReact \u4f1a\u81ea\u52a8\u8c03\u7528\u8be5\u51fd\u6570\u5e76\u4f20\u5165 FormData<\/code>\u3002<\/p>\n
    \u7b2c\u4e8c\u6b65\uff1a\u5728\u670d\u52a1\u7aef\u7ec4\u4ef6\u4e2d\u76f4\u63a5\u4f7f\u7528 Server Action<\/h2>\n
    Server Actions \u4e5f\u53ef\u4ee5\u76f4\u63a5\u5728\u670d\u52a1\u7aef\u7ec4\u4ef6\u4e2d\u5b9a\u4e49\u548c\u4f7f\u7528\uff0c\u65e0\u9700 'use client'<\/code>\uff1a<\/p>\n
    \n\/\/ app\/server-form\/page.tsx\nimport { redirect } from 'next\/navigation';\n\nexport default function ServerFormPage() {\n  async function submitForm(formData: FormData) {\n    'use server';\n    const email = formData.get('email') as string;\n    \/\/ \u6a21\u62df\u4fdd\u5b58\u5230\u6570\u636e\u5e93\n    console.log('\u4fdd\u5b58\u90ae\u7bb1:', email);\n    redirect('\/success');\n  }\n\n  return (\n    <form action={submitForm}>\n      <input name="email" type="email" placeholder="\u4f60\u7684\u90ae\u7bb1" required \/>\n      <button type="submit">\u8ba2\u9605<\/button>\n    <\/form>\n  );\n}\n<\/code><\/pre>\n
    \u8fd9\u91cc submitForm<\/code> \u662f\u5185\u8054\u7684 Server Action\uff0c\u5b83\u53ea\u80fd\u5728\u8be5\u7ec4\u4ef6\u5185\u4f7f\u7528\u3002redirect<\/code> \u6765\u81ea next\/navigation<\/code>\uff0c\u7528\u4e8e\u670d\u52a1\u7aef\u91cd\u5b9a\u5411\u3002<\/p>\n
    \u7b2c\u4e09\u6b65\uff1a\u7ed3\u5408 useFormState \u5904\u7406\u8868\u5355\u72b6\u6001<\/h2>\n
    React 19 \u63d0\u4f9b\u4e86 useFormState<\/code>\uff08\u5728 Next.js \u4e2d\u4ece react-dom<\/code> \u5bfc\u5165\uff09\u6765\u7ba1\u7406\u8868\u5355\u63d0\u4ea4\u540e\u7684\u72b6\u6001\u548c\u9519\u8bef\u4fe1\u606f\u3002<\/p>\n
    \u9996\u5148\u5b9a\u4e49 action\uff1a<\/p>\n
    \n\/\/ app\/actions.ts\n'use server';\n\nexport async function subscribe(prevState: any, formData: FormData) {\n  const email = formData.get('email') as string;\n  \n  if (!email || !email.includes('@')) {\n    return { error: '\u8bf7\u8f93\u5165\u6709\u6548\u7684\u90ae\u7bb1\u5730\u5740' };\n  }\n  \n  \/\/ \u6a21\u62df\u4fdd\u5b58\n  await new Promise((resolve) => setTimeout(resolve, 1000));\n  return { success: `\u8ba2\u9605\u6210\u529f\uff1a${email}` };\n}\n<\/code><\/pre>\n
    \u5728\u5ba2\u6237\u7aef\u7ec4\u4ef6\u4e2d\u4f7f\u7528\uff1a<\/p>\n
    \n\/\/ app\/components\/SubscribeForm.tsx\n'use client';\n\nimport { useFormState, useFormStatus } from 'react-dom';\nimport { subscribe } from '..\/actions';\n\nfunction SubmitButton() {\n  const { pending } = useFormStatus();\n  return (\n    <button type="submit" disabled={pending}>\n      {pending ? '\u63d0\u4ea4\u4e2d...' : '\u8ba2\u9605'}\n    <\/button>\n  );\n}\n\nexport default function SubscribeForm() {\n  const [state, formAction] = useFormState(subscribe, null);\n\n  return (\n    <form action={formAction}>\n      <input name="email" type="email" placeholder="\u4f60\u7684\u90ae\u7bb1" required \/>\n      <SubmitButton \/>\n      {state?.error && <p style={{ color: 'red' }}>{state.error}<\/p>}\n      {state?.success && <p style={{ color: 'green' }}>{state.success}<\/p>}\n    <\/form>\n  );\n}\n<\/code><\/pre>\n
    useFormStatus<\/code> \u5fc5\u987b\u7528\u5728 <\/p>\n<\/code> \u7684\u5b50\u7ec4\u4ef6\u4e2d\uff0c\u5b83\u63d0\u4f9b pending<\/code> \u72b6\u6001\uff0c\u907f\u514d\u624b\u52a8\u7ba1\u7406 loading\u3002<\/p>\n
    \u7b2c\u56db\u6b65\uff1a\u8fdb\u9636\u2014\u2014\u4e50\u89c2\u66f4\u65b0\u4e0e\u9519\u8bef\u56de\u6eda<\/h2>\n
    \u5bf9\u4e8e\u70b9\u8d5e\u3001\u6536\u85cf\u7b49\u4ea4\u4e92\uff0c\u6211\u4eec\u5e0c\u671b\u754c\u9762\u7acb\u5373\u54cd\u5e94\uff0c\u800c\u4e0d\u662f\u7b49\u5f85\u670d\u52a1\u7aef\u8fd4\u56de\u3002React 19 \u7684 useOptimistic<\/code> \u53ef\u4ee5\u8f7b\u677e\u5b9e\u73b0\u4e50\u89c2\u66f4\u65b0\u3002<\/p>\n
    \n\/\/ app\/components\/LikeButton.tsx\n'use client';\n\nimport { useOptimistic } from 'react';\nimport { likePost } from '..\/actions';\n\nexport default function LikeButton({ postId, initialLikes }: { postId: string; initialLikes: number }) {\n  const [optimisticLikes, addOptimisticLike] = useOptimistic(\n    initialLikes,\n    (state, newLike: number) => state + newLike\n  );\n\n  async function handleLike() {\n    addOptimisticLike(1);\n    try {\n      await likePost(postId);\n    } catch (error) {\n      \/\/ \u9519\u8bef\u65f6 React \u4f1a\u81ea\u52a8\u56de\u6eda\u5230 initialLikes\n      alert('\u70b9\u8d5e\u5931\u8d25\uff0c\u8bf7\u91cd\u8bd5');\n    }\n  }\n\n  return (\n    <button onClick={handleLike}>\n      \ud83d\udc4d {optimisticLikes}\n    <\/button>\n  );\n}\n<\/code><\/pre>\n
    \u5bf9\u5e94\u7684 Server Action\uff1a<\/p>\n
    \n\/\/ app\/actions.ts\n'use server';\n\nexport async function likePost(postId: string) {\n  \/\/ \u6a21\u62df\u6570\u636e\u5e93\u66f4\u65b0\n  await new Promise((resolve) => setTimeout(resolve, 800));\n  \/\/ \u968f\u673a\u5931\u8d25\u4ee5\u6f14\u793a\u56de\u6eda\n  if (Math.random() < 0.3) {\n    throw new Error('\u70b9\u8d5e\u5931\u8d25');\n  }\n  console.log('\u70b9\u8d5e\u6210\u529f:', postId);\n}\n<\/code><\/pre>\n
    \u6ce8\u610f\uff1auseOptimistic<\/code> \u7684\u7b2c\u4e8c\u4e2a\u53c2\u6570\u662f\u66f4\u65b0\u51fd\u6570\uff0c\u5b83\u63a5\u6536\u5f53\u524d\u72b6\u6001\u548c\u4e50\u89c2\u503c\uff0c\u8fd4\u56de\u65b0\u72b6\u6001\u3002\u5f53 action \u5b8c\u6210\u540e\uff0cReact \u4f1a\u4f7f\u7528\u771f\u5b9e\u6570\u636e\u91cd\u65b0\u6e32\u67d3\u3002<\/p>\n
    \u7b2c\u4e94\u6b65\uff1a\u5b89\u5168\u4e0e\u9a8c\u8bc1\u6700\u4f73\u5b9e\u8df5<\/h2>\n
    Server Actions \u662f\u516c\u5f00\u7684 HTTP \u7aef\u70b9\uff0c\u5fc5\u987b\u8fdb\u884c\u8f93\u5165\u9a8c\u8bc1\u548c\u6743\u9650\u68c0\u67e5\u3002\u63a8\u8350\u4f7f\u7528 zod<\/code>\uff1a<\/p>\n
    \n\/\/ app\/actions.ts\n'use server';\n\nimport { z } from 'zod';\n\nconst schema = z.object({\n  title: z.string().min(1, '\u6807\u9898\u4e0d\u80fd\u4e3a\u7a7a').max(100),\n  content: z.string().min(10, '\u5185\u5bb9\u81f3\u5c1110\u4e2a\u5b57\u7b26'),\n});\n\nexport async function createPost(prevState: any, formData: FormData) {\n  const raw = {\n    title: formData.get('title'),\n    content: formData.get('content'),\n  };\n\n  const result = schema.safeParse(raw);\n  if (!result.success) {\n    return { errors: result.error.flatten().fieldErrors };\n  }\n\n  \/\/ \u68c0\u67e5\u7528\u6237\u8eab\u4efd\uff08\u793a\u4f8b\uff09\n  \/\/ const session = await getSession();\n  \/\/ if (!session) return { error: '\u8bf7\u5148\u767b\u5f55' };\n\n  \/\/ \u4fdd\u5b58\u5230\u6570\u636e\u5e93\n  await savePost(result.data);\n  return { success: true };\n}\n<\/code><\/pre>\n
    \ud83d\udca1 \u91cd\u8981\u63d0\u9192<\/strong>\uff1a\u6c38\u8fdc\u4e0d\u8981\u4fe1\u4efb\u5ba2\u6237\u7aef\u4f20\u5165\u7684\u6570\u636e\uff0c\u5373\u4f7f\u8868\u5355\u6709 required<\/code> \u5c5e\u6027\u3002\u670d\u52a1\u7aef\u9a8c\u8bc1\u662f\u5fc5\u987b\u7684\u3002<\/p>\n
    \u5e38\u89c1\u5751\u4e0e\u89e3\u51b3\u65b9\u6848<\/h2>\n
    1. \u5728\u5ba2\u6237\u7aef\u7ec4\u4ef6\u4e2d\u5bfc\u5165 Server Action \u62a5\u9519<\/h3>\n
    \u786e\u4fdd\u6587\u4ef6\u9876\u90e8\u6709 'use server'<\/code>\uff0c\u4e14\u53ea\u5bfc\u51fa\u5f02\u6b65\u51fd\u6570\u3002\u5982\u679c\u6df7\u5408\u5bfc\u51fa\u540c\u6b65\u51fd\u6570\uff0c\u4f1a\u62a5\u9519\u3002<\/p>\n
    2. \u65e0\u6cd5\u5728 Server Action \u4e2d\u4f7f\u7528 React Hooks<\/h3>\n
    Server Actions \u5728\u670d\u52a1\u7aef\u6267\u884c\uff0c\u4e0d\u80fd\u4f7f\u7528 useState<\/code>\u3001useEffect<\/code> \u7b49\u3002\u5982\u679c\u9700\u8981\u72b6\u6001\uff0c\u8bf7\u901a\u8fc7\u53c2\u6570\u4f20\u9012\u6216\u4f7f\u7528 cookies()<\/code>\u3001headers()<\/code> \u7b49\u670d\u52a1\u7aef API\u3002<\/p>\n
    3. \u91cd\u65b0\u9a8c\u8bc1\u6570\u636e<\/h3>\n
    \u5728 Server Action \u4e2d\u4fee\u6539\u6570\u636e\u540e\uff0c\u9700\u8981\u8c03\u7528 revalidatePath<\/code> \u6216 revalidateTag<\/code> \u6765\u66f4\u65b0\u7f13\u5b58\uff1a<\/p>\n
    \nimport { revalidatePath } from 'next\/cache';\n\nexport async function addTodo(formData: FormData) {\n  'use server';\n  const todo = formData.get('todo') as string;\n  await db.todos.create({ data: { text: todo } });\n  revalidatePath('\/todos'); \/\/ \u91cd\u65b0\u9a8c\u8bc1 \/todos \u8def\u5f84\n}\n<\/code><\/pre>\n
    4. \u9519\u8bef\u5904\u7406<\/h3>\n
    Server Action \u629b\u51fa\u7684\u9519\u8bef\u4f1a\u88ab React \u6355\u83b7\uff0c\u4f46\u751f\u4ea7\u73af\u5883\u5e94\u907f\u514d\u6cc4\u9732\u654f\u611f\u4fe1\u606f\u3002\u5efa\u8bae\u8fd4\u56de\u7ed3\u6784\u5316\u7684\u9519\u8bef\u5bf9\u8c61\uff0c\u800c\u4e0d\u662f\u76f4\u63a5\u629b\u51fa\u3002<\/p>\n
    \u603b\u7ed3<\/h2>\n
    Server Actions \u6781\u5927\u5730\u7b80\u5316\u4e86 React \u5168\u6808\u5f00\u53d1\u7684\u6570\u636e\u53d8\u66f4\u6d41\u7a0b\u3002\u901a\u8fc7\u672c\u6587\uff0c\u4f60\u5b66\u4f1a\u4e86\uff1a<\/p>\n