数据访问层 (DAL)
优先级: P1 (高)
集中所有数据访问(数据库和外部API),以确保一致的安全性、授权和缓存。
实现指南
- 架构:在
services/或lib/data.ts文件中创建数据访问层 (DAL)。使用import 'server-only'来防止后端逻辑泄露到客户端 bundle。 - DTO:在返回给组件之前,始终将原始数据库/API 数据转换为数据传输对象 (DTO)。这可以防止泄露敏感字段(例如
passwordHash)。 - 安全:使用来自
experimental_taintAPI 的taintObjectReference或taintUniqueValue,确保敏感数据绝不会意外到达客户端组件。 - 授权:在每个 DAL 函数内部内联授权检查。不要依赖 UI 层来强制执行安全性。使用
await auth()来验证用户。 - 缓存:将 DAL 函数包裹在 React 的
cache()中,以在单个渲染周期内对请求进行去重,防止冗余的数据库/API 调用。 - 错误处理:抛出标准化错误(例如
NotFoundError、UnauthorizedError),以便由 Next.jserror.tsx或notFound()捕获。
限制
- 客户端组件:无法导入 DAL 文件。必须使用 Server Action 或 Route Handler 作为桥梁。
反模式
- 在 DAL 外部进行授权检查:授权验证必须位于 DAL 函数内部。
- 返回原始 ORM 实例:在返回之前转换为纯 DTO 对象。
- 在服务端组件中使用
fetch('localhost/api'):直接调用 DAL 函数。 - 在客户端组件中导入 DAL:使用 Server Action 或 Route Handler 作为桥梁。