Next.js 13中Middleware属于服务端还是客户端？求场景与限制说明

定位：服务端边缘执行逻辑 #

Next.js 13的Middleware完全属于服务端范畴，更准确说是运行在边缘runtime环境中——它不会被打包到客户端代码里，所有逻辑都在请求到达页面/API路由之前，在服务器或边缘节点完成处理，和客户端浏览器没有直接交互。

核心适用场景 #

• 路由权限校验：验证用户JWT令牌、角色权限，未授权时直接重定向到登录页或返回403状态码
• URL规则统一处理：批量完成旧路由到新路由的重定向，或根据设备类型、地域调整请求路径
• 请求上下文修改：给请求头注入自定义标识、修改查询参数，为后续路由处理提供前置数据
• 无客户端依赖的AB测试：根据用户特征（如IP、Cookie）分配不同页面版本，无需客户端逻辑介入
• 全局请求监控：统一收集所有入站请求的日志、性能数据，无需在每个路由单独埋点
• 地域化适配：基于用户IP判断地区，自动切换多语言版本或展示地区专属内容

关键限制 #

• 运行环境约束：默认边缘runtime不支持Node.js核心模块（如fs、child_process），若需使用需配置runtime: 'nodejs'，但会失去边缘部署的低延迟优势
• 执行时长限制：边缘环境下Middleware有严格的超时限制（通常几秒内），复杂计算、远程调用等耗时操作容易触发超时
• 资源访问限制：无法直接连接数据库或内部服务，必须通过API接口间接访问，避免阻塞请求链路
• 路由匹配局限：仅能通过next.config.js的matcher配置或内置路由规则触发，无法精准匹配部分复杂路由场景
• 状态获取限制：无法直接读取客户端本地状态（如localStorage），只能依赖请求头、Cookie或URL参数传递的信息

内容的提问来源于stack exchange，提问作者Vijay