用途
该技能用于服务端应用开发,帮助构建可上生产环境的后端系统,覆盖多种框架、语言与部署策略。其专长包括:构建可扩展 API、数据库设计、认证系统,以及生产就绪的后端基础设施。
适用场景包括:
- 构建 REST 或 GraphQL API
- 设计数据库 schema 与模型
- 实现认证与授权
- 搭建服务器基础设施
- 创建微服务或单体后端
- 优化后端性能
- 将服务端应用部署到生产环境
- 需要多框架后端指导(Express、FastAPI、Django、Spring)
不建议使用的场景:
- 仅需前端开发 → 使用 frontend-developer 或 nextjs-developer
- 需要数据库专项优化 → 使用 database-optimizer 或 postgres-pro
- 只做 API 设计而不实现 → 使用 api-designer
- GraphQL 专项架构 → 使用 graphql-architect
- 仅 DevOps/基础设施 → 使用 devops-engineer 或 cloud-architect
主要能力
框架支持:
- Node.js/TypeScript:Express.js、NestJS、Koa.js、Fastify
- Python:FastAPI、Django、Flask、Tornado
- Java:Spring Boot、Quarkus、Micronaut
- Go:Gin、Echo、Fiber
框架选型决策框架:
- JavaScript/TypeScript:需要快速开发加类型安全选 NestJS;需要轻量高性能选 Fastify;需要简单与生态选 Express.js
- Python:需要异步与高性能选 FastAPI;需要开箱即用选 Django(加 DRF)
- Java:企业级选 Spring Boot
- Go:高性能服务选 Gin 或 Fiber
认证策略矩阵:
- 无状态 API(移动端、SPA):JWT,复杂度低,安全性中
- 第三方登录:OAuth 2.0,复杂度中,安全性高
- 传统 Web 应用:基于 Session,复杂度低,安全性高
- 微服务:JWT + API Gateway,复杂度高,安全性高
- 企业 SSO:SAML 2.0,复杂度高,安全性很高
数据库与 ORM 选择:
- 关系型(SQL):Node.js/TypeScript 需要类型安全与迁移选 Prisma,需要灵活性选 TypeORM 或 Sequelize;Python 需要异步选 Tortoise ORM 或 SQLModel,同步/Django 选 Django ORM 或 SQLAlchemy;Java 选 JPA(Hibernate)或 jOOQ
- NoSQL:文档存储选 MongoDB(Node.js 用 Mongoose);键值选 Redis(缓存、会话)
使用方式
在以下情况调用该技能:
- 用 Node.js、Python、Java 或 Go 构建服务端 API(REST、GraphQL)
- 实现认证/授权(JWT、OAuth2、基于 Session)
- 设计数据库 schema 与 ORM 集成
- 搭建后端测试(单元、集成、E2E)
- 实现中间件(日志、验证、错误处理)
- 将后端服务部署到 Kubernetes、AWS、GCP 或 Azure
- 优化后端性能(缓存、查询优化、限流)
最佳实践
- 始终验证输入——使用提供的验证中间件
- 优雅处理错误——使用生成的错误处理器
- 编写测试——使用测试模板保持一致
- 使用环境变量——绝不硬编码密钥
- 实现日志——使用提供的日志配置
- 监控性能——设置指标与告警
- 安全优先——使用提供的认证设置
- 对 API 进行版本管理——遵循版本化模式
- 为代码写文档——自动生成 API 文档
- 安全部署——使用提供的部署脚本
常见模式
- Repository 模式:关注点分离、易于测试、实现可替换
- Service Layer:集中业务规则、事务管理、错误处理
- Middleware Stack:认证、授权、验证、日志、错误处理
故障排查
常见问题与检查方向:
- 数据库连接错误:检查连接字符串、确认数据库运行、检查网络连通性、复查连接池设置
- 认证失败:验证 JWT 密钥、检查令牌过期、校验令牌格式、复查中间件顺序
- 构建失败:检查 TypeScript 配置、确认依赖已安装、复查错误信息、检查语法错误
- 部署问题:验证 Docker 镜像构建、检查 Kubernetes pod、复查日志、验证环境变量
质量检查清单
安全:所有端点进行输入验证(Zod/Joi);密码哈希(bcrypt cost 10+ 或 Argon2);防止 SQL 注入(参数化查询);认证端点限流;安全响应头(Helmet.js);密钥使用环境变量。
认证与授权:强 JWT 密钥(256 位);短生命周期访问令牌(15 分钟);刷新令牌轮换;受保护路由做授权检查。
错误处理:全局错误处理器;异步错误处理(express-async-errors);清晰的验证错误信息;未知端点的 404 处理。
性能:数据库连接池;查询优化(避免 N+1);缓存(Redis 用于会话、限流);响应压缩(gzip/brotli)。
测试:服务/仓库的单元测试;API 端点的集成测试;关键路径覆盖率 >80%;独立的测试数据库。
附加资源
- 详细技术参考:参见 REFERENCE.md
- 代码示例与模式:参见 EXAMPLES.md
限制
资料中未提供收费、价格、平台或具体使用效果等信息,这些内容暂未提供。