Clerk认证问题：未注册用户登录跳转异常，如何配置跳转至注册页？

架构老林

2026-6-29

解决Clerk未注册用户登录时跳转注册页的配置问题

可以通过两种方式实现需求，分别是Clerk后台配置和代码逻辑调整：

一、通过Clerk Dashboard全局配置

登录Clerk Dashboard，进入你的应用控制台
导航到 Authentication > Sign-in 页面
在"Unregistered users"设置区域，选择"Redirect to sign-up"选项
保存设置后，未注册用户尝试登录时会自动跳转至注册页面

二、代码层面调整（结合你的Middleware）

如果需要更灵活的跳转逻辑，可以直接修改middleware中的跳转行为，替换默认的redirectToSignIn为注册页跳转：

export default authMiddleware({
    publicRoutes: ['/'],
    afterAuth(auth, req, evt) {
        // 未认证用户访问私有路由时，直接跳转至注册页
        if (!auth.userId && !auth.isPublicRoute) {
            // 携带returnBackUrl参数，用户注册后可返回原页面
            return redirect(`/sign-up?returnBackUrl=${encodeURIComponent(req.url)}`);
        }
        
        if (auth.userId && auth.isPublicRoute) {
            return redirect("/dashboard");
        }
    },
});
 
export const config = {
  matcher: ["/((?!.+\\.[\\w]+$|_next).*)", "/", "/(api|trpc)(.*)"],
};

前端组件补充优化

如果是前端登录组件触发的跳转，可以在SignIn组件中监听登录失败事件，针对"用户未注册"的错误跳转至注册页：

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

export default function SignInPage() {
  return (
    <SignIn
      onSignInFailed={(error) => {
        // 匹配Clerk返回的用户未注册错误码
        if (error.code === "user_not_found") {
          window.location.href = `/sign-up?returnBackUrl=${encodeURIComponent(window.location.pathname)}`;
        }
      }}
    />
  );
}