使用react-beautiful-dnd时已用React.forwardRef仍出现MenuItem传ref报错
报错原因定位
- ref传递链路中断
你通过React.forwardRef包裹了RefMenuItem组件,获取到外部传入的ref后直接将其作为prop传给MenuItem。如果使用的是MUI v3及更早版本的MenuItem,这类组件本身是不具备ref透传能力的函数组件,且设计上是通过innerRef属性接收DOM节点引用,而非标准的refprop。你直接传refprop给MenuItem,既会触发「Function components cannot be given refs」的报错,也无法将ref传到最终渲染的DOM节点上,react-beautiful-dnd无法正常识别拖拽目标。 - 组件嵌套结构违规
MUI Select的内部实现依赖直接遍历传入的子元素匹配选中值、绑定点击事件,要求MenuItem作为直接子元素传入。你将DragDropContext、Droppable这类拖拽容器嵌套在Select内部,相当于给MenuItem套了多层非预期的父容器,Select无法识别合法子元素,会进一步导致功能失效。 - 属性透传不完整
你在RefMenuItem中手动筛选传递给MenuItem的属性,仅传递了onClick和ref,完全遗漏了Select自动注入到MenuItem的selected、value、tabIndex、role等核心props,导致MenuItem的选中态、交互逻辑完全异常。
正确修复方案
- 理顺ref传递链路,确保ref能最终落到真实DOM节点上
- 若使用MUI v4及以上版本:MenuItem本身已内置forwardRef支持,可直接接收
refprop,无需额外手动处理 - 若使用MUI v3及更早版本:不要直接传
refprop给MenuItem,改用组件提供的innerRef属性传入ref值,打通传递链路
- 若使用MUI v4及以上版本:MenuItem本身已内置forwardRef支持,可直接接收
- 调整组件嵌套层级,将DragDropContext移到Select组件的外层,不要把拖拽相关的容器嵌套在Select内部,避免Select无法识别合法子元素
- 完善属性透传逻辑,在RefMenuItem中不要手动筛选传递的props,完整透传所有与MenuItem相关的属性,避免遗漏Select注入的核心逻辑
修复后的参考代码:
// 带ref透传的MenuItem组件 const RefMenuItem = React.forwardRef((props, ref) => { // 拆分出自定义的拖拽相关属性,避免污染MenuItem的原生props const { dragHandleProps, draggableProps, ...restMenuItemProps } = props return ( <MenuItem // MUI v3用innerRef,v4及以上用ref,根据实际版本选择对应属性 innerRef={ref} {...restMenuItemProps} {...draggableProps} {...dragHandleProps} > {props.children} </MenuItem> ) }) // 可拖拽的MenuItem项 function DraggableItem({ item, index, onClick, selectedValue }) { return ( <Draggable draggableId={item.id} index={index}> {provided => ( <RefMenuItem ref={provided.innerRef} onClick={onClick} value={item.id} selected={selectedValue === item.id} dragHandleProps={provided.dragHandleProps} draggableProps={provided.draggableProps} > <DragIndicatorIcon /> {item.name} <CreateIcon /> </RefMenuItem> )} </Draggable> ) } // 外层结构调整:将DragDropContext移到Select外部 <DragDropContext onDragEnd={onDragEnd}> <Select variant='outlined' value={selectedValue} className={selectClasses} > <Droppable droppableId='list'> {provided => ( <div ref={provided.innerRef} {...provided.droppableProps}> {state.items.map((item, index) => ( <DraggableItem key={item.id} item={item} index={index} onClick={handleAudienceChange} selectedValue={selectedValue} /> ))} {provided.placeholder} </div> )} </Droppable> </Select> </DragDropContext>
注意事项
- 确保使用的MUI版本与ref传递方式匹配,避免出现ref传递断链
- 不要在Select组件内部嵌套非业务相关的容器元素,否则会导致Select的选中逻辑失效
- react-beautiful-dnd要求
provided.innerRef必须绑定到真实DOM节点上,不能绑定到无透传能力的函数组件上
内容的提问来源于stack exchange,提问作者Max
相关产品推荐
相关产品推荐

