跳到内容
API 参考文件约定unauthorized.js

unauthorized.js

此功能目前为实验性功能,可能会发生变化,不建议用于生产环境。请试用并分享您在 GitHub 上的反馈。

unauthorized 文件用于在身份验证期间调用 unauthorized 函数时渲染 UI。除了允许您自定义 UI 外,Next.js 还会返回 401 状态代码。

app/unauthorized.tsx
import Login from '@/app/components/Login'
 
export default function Unauthorized() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

参考

Props

unauthorized.js 组件不接受任何 props。

示例

向未经身份验证的用户显示登录 UI

您可以使用 unauthorized 函数来渲染带有登录 UI 的 unauthorized.js 文件。

app/dashboard/page.tsx
import { verifySession } from '@/app/lib/dal'
import { unauthorized } from 'next/navigation'
 
export default async function DashboardPage() {
  const session = await verifySession()
 
  if (!session) {
    unauthorized()
  }
 
  return <div>Dashboard</div>
}
app/unauthorized.tsx
import Login from '@/app/components/Login'
 
export default function UnauthorizedPage() {
  return (
    <main>
      <h1>401 - Unauthorized</h1>
      <p>Please log in to access this page.</p>
      <Login />
    </main>
  )
}

版本历史

版本变更
v15.1.0引入了 unauthorized.js