You need to enable JavaScript to run this app. Next.js中_app.js调用hooks报Invalid hook call,如何设置全局初始认证数据?
优惠活动
大模型
产品
解决方案
定价
更多

Next.js中_app.js调用hooks报Invalid hook call,如何设置全局初始认证数据?

报错根因

当前代码触发Invalid hook call的核心问题:

  • 类组件的render方法本身不支持调用React Hook,useDispatchAuth本质是useContext Hook,在类组件render内调用本身就违反Hook使用规则
  • 组件JSX结构中把AppProvider作为最外层包裹组件,意味着调用useDispatchAuth时,React还没有挂载对应的Provider组件上下文,Hook无法获取合法的上下文绑定,直接抛出无效调用错误
  • 在render阶段同步执行setInitialUserData会直接触发状态更新,即使解决了Hook问题,也会导致无限重渲染循环
  • 已经在getInitialProps中拿到了服务端返回的初始用户数据,完全不需要等客户端渲染后再异步执行逻辑、再dispatch更新,重复请求既浪费资源也增加状态不一致风险
  • 代码中引入的swrmutate逻辑属于冗余实现,当前场景没有依赖SWR缓存的状态共享需求,额外调用只会增加不必要的异步流程
修正实现

1. 调整Context Provider支持外部注入初始状态

修改/contexts/app.js,让Provider直接接收外部传入的初始认证数据,移除无意义的客户端重复初始化逻辑:

import { useReducer, useContext, createContext } from 'react'

const AppStateContext = createContext()
const AppDispatchContext = createContext()

const reducer = (state, action) => {
  switch (action.type) {
    case 'SET_AUTH':
      return action.payload
    default:
      throw new Error(`Unknown action: ${action.type}`)
  }
}

export const AppProvider = ({ children, initialAuthState }) => {
  // 优先使用外部传入的初始状态,兜底使用默认空状态
  const [state, dispatch] = useReducer(reducer, initialAuthState ?? {
    loading: false,
    loggedIn: false,
    user: null
  })

  return (
    <AppDispatchContext.Provider value={dispatch}>
      <AppStateContext.Provider value={state}>
        {children}
      </AppStateContext.Provider>
    </AppDispatchContext.Provider>
  )
}

export const useAuth = () => useContext(AppStateContext)
export const useDispatchAuth = () => useContext(AppDispatchContext)

2. 重构_app.js逻辑

删除类组件内所有Hook调用、所有渲染阶段执行的初始化函数,直接把getInitialProps拿到的服务端用户数据传给Provider作为初始值:

import 'bootstrap/dist/css/bootstrap.min.css'
import '../styles/globals.css'
import App from 'next/app'
import Layout from '../components/Layout'
import { AppProvider } from '../contexts/app'
import { getUser } from '../requests/userApi'

class MyApp extends App {
  render() {
    const { Component, pageProps, props } = this.props
    // 基于服务端拿到的数据直接构造初始认证状态,不需要客户端二次请求、二次dispatch
    const initialAuthState = {
      loading: false,
      loggedIn: !!props.user,
      user: props.user
    }

    return (
      <AppProvider initialAuthState={initialAuthState}>
        <Layout>
          <Component {...pageProps} />
        </Layout>
      </AppProvider>
    )
  }
}

MyApp.getInitialProps = async (appContext) => {
  const isServer = !!appContext.ctx.req
  let user = null
  let userTypes = {}

  // 仅在服务端拉取用户数据
  if (isServer) {
    try {
      const response = await getUser()
      const data = response.data
      if (data.status === true) {
        user = data.data.user
        userTypes = data.data.user_types
      }
    } catch (error) {
      // 接口异常场景静默处理
    }
  }

  return {
    props: {
      user,
      userTypes,
      isServer
    }
  }
}

export default MyApp
方案效果
  • 完全规避Hook调用位置违规问题,不在类组件render内调用任何Hook,从根源消除Invalid hook call报错
  • 认证数据在服务端渲染阶段完成注入,所有页面、组件首次渲染即可获取全量认证状态,无客户端异步等待延迟
  • 保留原有useAuth、useDispatchAuth的接口能力,业务组件不需要做任何适配修改
  • 移除渲染阶段触发的状态更新逻辑,避免无限重渲染导致的页面卡死问题

内容的提问来源于stack exchange,提问作者Nitin Singh Naruka

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 17:45:04