SuperAPI AI 工具集

backend-developer

编程与开发

查看项目

更新于 10-15 10:39

技能介绍

用途

该技能用于服务端应用开发,帮助构建可上生产环境的后端系统,覆盖多种框架、语言与部署策略。其专长包括:构建可扩展 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

限制

资料中未提供收费、价格、平台或具体使用效果等信息,这些内容暂未提供。