简介/API 参考文档/文件系统约定/unauthorized.js

unauthorized.js

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

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。

示例

向未认证用户展示登录界面

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

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>
}

版本历史

版本	变更说明
`v15.1.0`	引入 `unauthorized.js` 功能

unauthorized

关于 unauthorized 函数的 API 参考文档。

template.js

template.js 文件的 API 参考文档。

元数据文件

关于元数据文件约定的 API 文档。