跳到内容
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 函数来渲染 unauthorized.js 文件，并显示登录 UI。

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。

下一步

unauthorized

unauthorized 函数的 API 参考。