07. Server Functions：显式 RPC 边界

Next 有 Server Actions；TanStack Start 有 Server Functions。两者都能让客户端触发服务端逻辑，但边界设计不同。

基本形态

import { createServerFn } from '@tanstack/react-start'
import { z } from 'zod'

const createPost = createServerFn({ method: 'POST' })
  .validator(z.object({ title: z.string().min(1) }))
  .handler(async ({ data, context }) => {
    return context.db.posts.create({ title: data.title })
  })

和 Next Server Actions 的差异

一个更完整的例子：带鉴权上下文

const requireUser = createMiddleware().server(async ({ next, context }) => {
  const user = await context.auth.getUser()
  if (!user) throw new Error('Unauthorized')
  return next({ context: { user } })
})

export const updateProfile = createServerFn({ method: 'POST' })
  .middleware([requireUser])
  .validator(z.object({ displayName: z.string().min(2) }))
  .handler(async ({ data, context }) => {
    return context.db.profile.update({
      userId: context.user.id,
      displayName: data.displayName,
    })
  })

什么时候用 Server Function？

• 需要从客户端触发服务端 mutation。
• 需要访问 secrets、数据库、Cloudflare bindings。
• 需要 typed input/output。
• 需要可组合 middleware，例如 auth、tenant、rate limit。