Material UI Autocomplete结合React Hook Form与Recoil的异常问题
问题根因定位
- 自定义Autocomplete封装未正确对接React Hook Form(RHF)的
Controller受控逻辑:完全未使用Controller自动注入的field绑定参数,反而单独通过watch取值、手动设置默认值,这是freeSolo模式下状态错乱、下拉面板异常的核心原因。 - 远程typeahead场景缺少必要配置:没有关闭MUI Autocomplete默认的本地选项过滤逻辑,远程返回的选项列表会被前端本地逻辑二次筛选,导致列表不随输入动态更新;同时输入变更的触发未和Recoil请求链路打通,空值、重复值的判断存在边界漏洞。
- 校验触发逻辑冗余:手动在
onInputChange中调用setValue触发校验,和Controller本身的状态同步逻辑形成冲突,反而造成状态循环更新、弹层异常保持打开。
分步修正方案
1. 重构可复用Autocomplete组件的封装逻辑
核心调整:
- 直接使用Controller render props自动注入的
field参数,替代手动watch取值、设置默认值的旧逻辑 - 打通
onChange(选择下拉选项触发)和onInputChange(手动输入触发)的逻辑,适配freeSolo模式 - 完整保留业务侧传入的自定义回调、配置,不做无意义的覆盖
修正后的组件代码:
import { AutocompleteProps, Autocomplete as MuiAutocomplete, } from '@material-ui/lab' import {get} from 'lodash' import React, {ReactNode, useCallback} from 'react' import { Controller, ControllerProps, FieldError, useFormContext, } from 'react-hook-form' import {useRenderInput} from './hooks' interface Props extends Pick<ControllerProps, 'rules'>, Omit< AutocompleteProps<string, false, false, true>, 'error' | 'renderInput' > { helperText?: ReactNode label?: string name: string } export const Autocomplete = ({ helperText, label, name, rules, ...props }: Props) => { const {control, errors} = useFormContext() const error: FieldError | undefined = get(errors, name) const required = get(rules, 'required') !== undefined const renderAutocompleteInput = useRenderInput({ error: error !== undefined, helperText: get(error, 'message', helperText), label, required, }) return ( <Controller control={control} name={name} rules={rules} render={({field: {onChange, value}}) => ( <MuiAutocomplete // 关闭本地过滤逻辑,适配远程typeahead场景 filterOptions={(options) => options} {...props} value={value || ''} // 选择下拉选项时直接同步值到RHF onChange={(_, option) => onChange(option || '')} renderInput={renderAutocompleteInput} /> )} /> ) }
2. 调整父组件的调用逻辑
核心调整:
- 删除冗余的手动
setValue调用,Controller已经自动将输入值同步到RHF,无需手动干预 - 给Recoil触发的接口请求增加300ms防抖,避免高频输入造成的接口压力
- 配置RHF的校验模式,设置
mode: 'onChange'即可实现输入时实时触发必填、正则校验,无需手动调用校验方法
修正后的父组件核心代码:
// 初始化表单时开启onChange校验模式,实现输入实时校验 const { control } = useForm({ mode: 'onChange', defaultValues: { trainID: '' } }) const setTrainType = useSetRecoilState(TrainType) const trainsList = useRecoilValue(Trains) const trainOptions = useMemo(() => trainsList.map(trainIDFormatted), [trainsList]) // 增加防抖处理,避免每敲一个字符就触发Recoil状态更新和接口请求 const debouncedTrainTypeChange = useDebounce((inputVal: string) => { const capitalized = capitalize(inputVal) if (!capitalized) { setTrainType(undefined) return } // 仅将输入内容的首字符传给Recoil,触发对应接口请求 setTrainType(capitalized.charAt(0)) }, 300) const handleInputChange = useCallback( (_e: unknown, inputValue: string, reason: string) => { // 仅处理手动输入触发的事件,忽略选中、清空类事件 if (reason !== 'input') return debouncedTrainTypeChange(inputValue) }, [debouncedTrainTypeChange] ) <Autocomplete autoSelect freeSolo disabled={disabled} helperText=" " label="Select a train" name="trainID" options={trainOptions} rules={{ pattern: { message: 'Must match train ID pattern', value: /^(?:[A-Z]-?[A-Z ]{6}-?[0-9 ]-?[0-9 ]{2}[A-Z ])?$/, }, required: 'Train is required', }} onInputChange={handleInputChange} />
效果验证
- typeahead联动:关闭本地过滤后,远程返回的
trainOptions会直接展示在下拉面板;输入内容通过防抖更新Recoil的TrainType值,触发对应接口请求返回最新列表,输入内容变化时列表同步更新 - freeSolo适配:输入值通过Controller直接同步到RHF,组件内部状态和外部展示完全一致,不会出现下拉面板持续打开的异常,支持输入自定义的非预设值
- 实时校验:表单设置
mode: 'onChange'后,每次值变化都会自动执行必填校验、正则pattern匹配,错误信息会自动展示在helperText区域,无需手动触发校验

内容的提问来源于stack exchange,提问作者npabs18
相关产品推荐
相关产品推荐

