express-api-development

用途

该技能面向使用 Express.js 构建生产级 RESTful API 的开发场景，帮助开发者掌握中间件、路由、校验、认证以及生产环境最佳实践。资料中列出的适用时机包括：构建 RESTful API、创建 Express 中间件、实现认证、API 校验与错误处理、性能优化以及生产部署。

主要能力

资料以代码示例的形式展示了若干核心模式：

1. 基础 Express 服务器：引入 express、helmet、cors、compression，配置安全中间件、CORS、响应压缩、JSON 与 urlencoded 请求体解析，定义健康检查路由，并设置统一错误处理中间件与端口监听。

2. Router 模式：在独立路由文件中使用 Router，结合控制器、校验中间件与认证中间件，为资源定义 GET、POST、PUT、DELETE 等路由。

3. Controller 模式：以类的方式组织控制器，通过服务层处理业务逻辑，使用 try/catch 并将错误传递给 next 进行统一处理，返回 JSON 数据与相应状态码。

4. 校验中间件：使用 Zod 定义数据模式（如 name、email、age 的约束），在中间件中解析请求体，校验失败时返回 400 及错误详情。

5. 认证中间件：从 Authorization 头中提取 Bearer token，使用 jsonwebtoken 校验 JWT，将解码后的用户信息挂载到请求对象上，无 token 或校验失败时返回 401。

使用方式

资料未提供该技能的安装命令或具体调用方式，仅以代码示例展示 Express.js API 开发中的常见实现模式。开发者可参考这些示例组织项目结构，将路由、控制器、服务与中间件分层。

最佳实践

资料列出的最佳实践包括：使用 TypeScript 获得类型安全；实现完善的错误处理；用中间件处理横切关注点；校验所有输入数据；使用环境变量进行配置；实现限流；添加请求日志；对响应使用压缩；正确实现 CORS；使用 Helmet 添加安全响应头。

适用场景

适用于需要构建 RESTful API、编写 Express 中间件、实现认证、进行 API 校验与错误处理、做性能优化以及准备生产部署的项目。

限制

资料未说明该技能的收费、价格、支持平台、具体效果或详细安装步骤，这些信息暂未提供。相关资源链接为 Express 官方文档与 Node.js 最佳实践仓库。