Next.js中authMiddleware已弃用，其替代方案是什么？

Clerk 已对 Next.js 集成的中间件导入路径和配置逻辑做了更新，原从@clerk/nextjs/server导入的authMiddleware已被弃用，替代方案如下：

1. 更新导入路径 #

直接从@clerk/nextjs包导入authMiddleware，这是当前版本的标准导入方式：

import { authMiddleware } from "@clerk/nextjs";

2. 完整替代代码 #

保留原有路由匹配规则的同时，可按需添加自定义配置：

import { authMiddleware } from "@clerk/nextjs";

export default authMiddleware({
  // 可选：指定无需认证即可访问的公共路由
  publicRoutes: ["/", "/contact", "/blog/:slug"],
  // 可选：指定完全跳过Clerk认证的路由（如第三方webhook端点）
  ignoredRoutes: ["/api/webhooks/clerk"],
});

export const config = {
  matcher: ["/((?!.+\\.[\\w]+$|_next).*)", "/", "/(api|trpc)(.*)"],
};

3. 细粒度路由控制（可选） #

如果需要基于用户身份、角色做更灵活的路由保护，可以使用afterAuth钩子实现：

export default authMiddleware({
  afterAuth(auth, req, evt) {
    // 未登录用户访问非公共路由时，重定向到登录页
    if (!auth.userId && !auth.isPublicRoute) {
      return Response.redirect(new URL("/sign-in", req.url));
    }
    // 限制普通用户访问管理员专属路由
    if (auth.userId && auth.orgRole !== "admin" && req.nextUrl.pathname.startsWith("/admin")) {
      return Response.redirect(new URL("/dashboard", req.url));
    }
  },
});

关键说明 #

• 新的authMiddleware提供了更直观的配置项，替代了旧版本的隐式规则
• 原有matcher配置无需修改，依然用来指定中间件作用的路由范围

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