react-popper usePopper Hook在Storybook报TypeError: Object(...) is not a function
问题排查与解决步骤
最优先核对的常见触发原因
这个报错没有额外堆栈信息的核心场景,绝大多数情况不是业务逻辑问题,是依赖版本、导入缺失、模块实例冲突导致的:
- 检查
react-popper的实际安装版本usePopper这个Hook是react-popper@2.x版本才开始支持的API,如果本地实际安装的是1.x版本,导入得到的是undefined,调用的时候就会直接抛出TypeError: Object(...) is not a function。1.x版本的官方API只有<Popper>组件、<Manager>组件的声明式写法,不存在这个Hook导出。
- 检查基础导入是否完整
你贴的示例代码里没有显式导入useState,如果项目没有开启ES模块的自动导入插件,直接使用useState会导致模块上下文解析异常,报错信息和react-popper的导入异常高度相似,很容易被误判。正确的导入段必须显式引入依赖:import { useState } from 'react'; import { usePopper } from 'react-popper'; - 检查Storybook的模块打包配置
如果上述两项都没问题,大概率是Storybook运行环境存在React重复实例的问题:打包时项目本地的React和Storybook内部自带的React实例被同时加载,会导致Hook的上下文匹配失败,抛出同类类型错误。这种情况可以在Storybook的配置文件里配置路径别名,把所有react、react-dom的解析都指向项目本地安装的版本,避免双重实例注入。 - 检查React版本兼容度
usePopper作为React Hook,要求React版本最低为16.8.0,低于这个版本的React不支持Hook实现,调用时也会触发同类报错。
针对自定义触发组件场景的额外注意点
你提到需要支持通过props传入任意类型组件替换原生button作为触发元素,这里需要额外注意:
- 不要直接把
setReferenceElement这个ref回调直接透传给任意传入的自定义组件,绝大多数自定义组件不会自动把接收的ref转发到真实DOM节点上,会导致popper绑定的参考元素始终为null,哪怕运行不报错,定位逻辑也会完全失效。 - 可以通过
forwardRef对传入的自定义组件做一层包装,确保ref能正确绑定到组件渲染的真实DOM节点上,和原生button的ref绑定行为保持一致。
可直接运行的最小修复示例
import { useState, forwardRef } from 'react'; import { usePopper } from 'react-popper'; const CustomPopover = ({ TriggerComponent, content }) => { const [referenceElement, setReferenceElement] = useState(null); const [popperElement, setPopperElement] = useState(null); const [arrowElement, setArrowElement] = useState(null); const { styles, attributes } = usePopper(referenceElement, popperElement, { modifiers: [{ name: 'arrow', options: { element: arrowElement } }], }); // 包装传入的触发组件,实现ref透传 const ReferenceTrigger = forwardRef((props, ref) => ( <TriggerComponent {...props} ref={ref} /> )); return ( <> <ReferenceTrigger ref={setReferenceElement}> 触发元素 </ReferenceTrigger> <div ref={setPopperElement} style={styles.popper} {...attributes.popper}> {content} <div ref={setArrowElement} style={styles.arrow} /> </div> </> ); };
内容的提问来源于stack exchange,提问作者Jub10
相关产品推荐
相关产品推荐

