（3051期）PocketBase – 单文件开源后端，极速构建全功能API

单文件开源后端，极速构建全功能API 开源轻量级后端框架，集SQLite数据库、认证、实时订阅于一体，适合快速构建中小型应用 使用说明 核心用法 PocketBase 是一个基于 Go 语言的开源后端即服务(BaaS)框架，将 SQLite 数据库、实时订阅、认证系统和管理后台打包为单一可执行文件。开发者通过 JavaScript SDK (pocketbase) 与服务器交互，无需配置复杂的数据库或部署流程。 关键操作模式： 数据获取：使用 pb.collection('name').getList/getOne() 配合 expand 参数加载关联数据，过滤条件采用类 SQL 语法（&&/|| 连接，单引号字符串） 认证流程：pb.authStore 自动管理 JWT token，登录后请求自动携带凭证；OAuth2 在浏览器环境自动弹窗 实时订阅：通过 subscribe('*', callback) 监听数据变更，需手动清理订阅防止内存泄漏 文件处理：必须使用 FormData 上传，通过 pb.files.getURL() 获取访问地址 权限规则：字段级安全规则使用 @request.auth.id 等变量控制访问，注意空规则与空字符串规则的区别（前者拒绝所有，后者开放所有）。 扩展能力：通过 pb_hooks/*.pb.js 编写服务端 JavaScript 钩子，同步执行可拦截请求。 显著优点 部署极简：单二进制文件 + SQLite，无需 Docker 或数据库配置 开发体验流畅：实时重载、内置 Admin UI、类型安全的 SDK 功能集成度高：认证、文件存储、实时推送开箱即用 自托管友好：数据完全可控，无供应商锁定 局限性与风险 并发瓶颈：SQLite 写锁限制高并发写入场景 单节点架构：不支持原生分布式部署，横向扩展困难 钩子阻塞：JavaScript 钩子同步执行，耗时逻辑会拖慢请求 规则调试难：权限规则错误可能导致数据泄露或意外拒绝 适合人群 独立开发者、小型团队、原型项目、MVP 阶段应用，以及重视数据主权需要自托管的场景。不适合高并发、多区域部署或复杂事务需求的企业级应用。 常规风险 实时订阅未清理导致内存泄漏 文件 URL 手动拼接导致访问失效 混淆 pb.collection()（用户端）与 pb.collections（管理端）API 权限层级 过期 token 静默失效，isValid 检查遗漏引发数据不一致 原始说明 Build backends with PocketBase collections, auth, and realtime.