React / 系统课时

完善权限与校验

完善权限与校验

权限与校验的目标不是“让按钮消失”,而是保证无论请求来自页面、Route Handler 还是 Server Action,服务端都用同一套规则判断“谁能对什么数据做什么”,并在写入前拒绝非法状态和越权操作。

学习目标

  • 区分身份认证、对象级授权、输入结构校验和业务规则校验
  • 在服务端入口与数据写入边界执行统一的权限判断
  • 用稳定的状态码和错误码验证未登录、越权、非法输入与业务冲突

把校验拆成四层

一个写请求至少要经过四层检查。先确认调用者身份,再判断他是否有权操作目标对象;随后校验请求结构和字段范围,最后检查“归档内容不能再次发布”这类业务规则。客户端校验可以改善体验,但不能作为安全边界,因为请求可以绕过页面直接发送。

页面、接口与数据操作共享服务端权限校验链路

在 Route Handler 中落实服务端规则

下面是片段示例,假设项目已经提供 auth()、Prisma 客户端 db,安装了 zod,并把用户角色扩展到 session.user.role。重点是检查顺序,而不是某个认证库的具体配置。

ts
import { z } from "zod";
import { auth } from "@/auth";
import { db } from "@/lib/db";

const ParamsSchema = z.object({
  id: z.string().uuid(),
});

const BodySchema = z.object({
  title: z.string().trim().min(1).max(120),
  status: z.enum(["draft", "published"]),
});

export async function PATCH(
  request: Request,
  { params }: { params: Promise<{ id: string }> },
) {
  const session = await auth();
  if (!session?.user?.id) {
    return Response.json({ code: "unauthenticated" }, { status: 401 });
  }

  const parsedParams = ParamsSchema.safeParse(await params);
  const parsedBody = BodySchema.safeParse(
    await request.json().catch(() => null),
  );
  if (!parsedParams.success || !parsedBody.success) {
    return Response.json({ code: "invalid_request" }, { status: 400 });
  }

  const post = await db.post.findUnique({
    where: { id: parsedParams.data.id },
    select: { ownerId: true, status: true },
  });
  if (!post) {
    return Response.json({ code: "not_found" }, { status: 404 });
  }

  const isAdmin = session.user.role === "admin";
  if (!isAdmin && post.ownerId !== session.user.id) {
    return Response.json({ code: "forbidden" }, { status: 403 });
  }

  if (post.status === "archived") {
    return Response.json({ code: "post_archived" }, { status: 409 });
  }

  const updated = await db.post.update({
    where: { id: parsedParams.data.id },
    data: parsedBody.data,
    select: { id: true, title: true, status: true },
  });

  return Response.json({ post: updated }, { status: 200 });
}

这段代码把用户提交的 userId 完全排除在可信输入之外,权限主体只来自服务端会话。若 ownerId 或状态可能被其他事务并发修改,应把“读取、授权、写入”放进事务,或把授权条件直接放进更新谓词,避免检查通过后数据又发生变化。

让页面和数据操作复用同一规则

页面层可以先做登录检查和可见性控制,例如未登录时跳转登录页、无权限时返回 404;但真正修改数据的 Server Action、Route Handler 或服务方法仍要再次授权。不要把“这个页面进不去”当成“这个接口不会被调用”。

更稳妥的做法是把 updatePostForUser(user, input) 这类业务函数放在服务端模块中,让不同入口都调用它。函数内部负责对象级授权与业务规则,入口层只负责读取请求、转换输入以及把领域错误映射成 HTTP 响应或页面状态。这样规则不会因为新增入口而漏掉。

验证所有失败路径

完成实现后,不只测试管理员成功更新,还要覆盖拒绝路径。至少确认下面这些结果与接口约定一致。

场景 预期结果
未登录 401,错误码 unauthenticated
id 或请求体不合法 400,错误码 invalid_request
目标数据不存在 404,错误码 not_found
普通用户修改他人数据 403,错误码 forbidden
归档数据再次修改 409,错误码 post_archived
合法用户修改自己的数据 200,仅返回允许暴露的字段

最终应形成一条可重复的安全规则:客户端负责体验,服务端负责信任;每次写入都重新确认身份、对象权限、输入结构和业务状态,数据库只接收已经通过这些检查的数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

完善权限与校验

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

登录哪都通