Next.js自定义组件使用getInitialProps无法传递props问题求助
Next.js 中自定义组件
getInitialProps不生效的问题定位与解法 核心根因
你遇到的props传不进去的现象,是两个常见实现误区叠加导致的:
- 对
getInitialProps的生效范围理解偏差
Next.js 框架只会自动为pages目录下的页面路由组件挂载getInitialProps的执行与props注入逻辑:路由匹配完成后,框架会自动调用对应页面组件上定义的getInitialProps方法,把返回的对象合并为组件入参props。
对于普通的自定义公共组件,哪怕你给它挂了getInitialProps方法,框架也不会主动执行、更不会自动把返回值注入成组件props。你能看到console.log输出,通常是两种场景:- 你临时把这个组件放到pages目录下当过页面路由测试,触发了方法执行流程
- 你在引用组件的代码里手动调用过这个组件的
getInitialProps方法,所以打印了日志,但从来没有把方法返回的对象,作为props实际传到组件渲染的参数里
- JSX渲染逻辑的写法bug
就算props真的成功传到组件里,你代码里写的<h1>props.name</h1>是把这串文本当成普通静态字符串渲染的,没有用{}包裹JS表达式,变量值根本不会被读取,正确写法是<h1>{props.name}</h1>
可落地的解决方式
- 公共组件需要获取服务端数据时,不要把
getInitialProps挂在组件自身上,统一在页面级路由组件的getInitialProps中完成服务端数据获取,再把数据通过props逐层传给公共子组件
参考正确实现的代码结构:
对应的公共组件就回归纯展示组件逻辑,不需要自带数据获取逻辑:// pages/index.js 页面级组件,getInitialProps在这里才会被Next.js自动触发 import HeaderMain from '../components/HeaderMain' const Home = (pageProps) => { return <HeaderMain customName={pageProps.headerInfo.name} /> } Home.getInitialProps = async ({ req }) => { // 在这里完成所有服务端逻辑:读取请求信息、请求后端接口等 console.log({ req }) return { headerInfo: { name: "Paul" } } } export default Home// components/HeaderMain.js const HeaderMain = (props) => { return <h1>{props.customName}</h1> } export default HeaderMain - 如果使用的是Next.js 12及以上的版本,更推荐用
getServerSideProps/getStaticProps替代getInitialProps做页面级数据获取,数据传递的逻辑和上面的模式完全一致。
内容的提问来源于stack exchange,提问作者Paul A.T. Wilson
相关产品推荐
相关产品推荐

