You need to enable JavaScript to run this app. react-popper usePopper Hook在Storybook报TypeError: Object(...) is not a function
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 03:15:05