React Hook Form中使用Lodash防抖的AsyncSelect无法加载选项
React Hook Form 场景下AsyncSelect 防抖加载的正确实现
原代码出现加载失效的核心原因
- 函数组件每次重渲染时,都会在函数执行体中重新调用
_.debounce生成全新的防抖函数实例,之前挂载的定时器、调用状态全部丢失,根本达不到防抖的延时等待效果,AsyncSelect拿到的方法引用每次都在变化,内部状态追踪出错 - 没有兼容AsyncSelect的
loadOptions方法的参数约定,原代码只给方法透传了输入文本值,没有处理组件内置的结果回调逻辑,异步结果没法正常传回组件渲染选项 - 部分写法下没有给防抖函数做实例缓存,连续触发输入时直接生成一堆独立的防抖方法,之前的待执行请求根本没法被取消,甚至会触发竞态问题
可直接落地的正确实现方案
- 用
useRef在组件整个生命周期内缓存唯一的防抖函数实例,避免重渲染时重复创建 - 适配AsyncSelect的
loadOptions参数规则:除了接收输入文本,还要接收组件传入的结果回调,拿到异步请求结果后主动调用回调完成选项渲染 - 组件卸载时手动清理待执行的防抖定时器,避免内存泄漏
- 用React Hook Form Controller 新版的
render属性替代旧的as属性绑定组件,确保value、onChange等表单值能正确透传
完整可运行代码示例
import { useRef, useEffect } from 'react'; import { Controller } from 'react-hook-form'; import AsyncSelect from 'react-select/async'; import _ from 'lodash'; import axios from 'axios'; const NoteFormMaster = ({ control }) => { // 缓存防抖函数实例,全组件只生成一次 const debouncedLoadRef = useRef(null); // 封装异步请求逻辑 const fetchUserOptions = async (inputText = '') => { try { const res = await axios.get(`/v1/user?username=${inputText}`); return res.data.map(user => ({ value: user.id, label: user.username })); } catch (err) { alert(JSON.stringify(err)); return []; } }; // 首次挂载时初始化防抖实例 if (!debouncedLoadRef.current) { debouncedLoadRef.current = _.debounce(async (inputValue, callback) => { const options = await fetchUserOptions(inputValue); // 主动调用AsyncSelect的回调把结果传给组件渲染 callback(options); }, 3000); } // 组件卸载时清理未执行的防抖任务 useEffect(() => { return () => { debouncedLoadRef.current?.cancel(); }; }, []); return ( <Controller control={control} name="shareWith" render={({ field }) => ( <AsyncSelect {...field} loadOptions={(inputValue, callback) => debouncedLoadRef.current(inputValue, callback)} defaultValue={[]} isMulti isClearable defaultOptions={[]} /> )} /> ); };
常见踩坑提醒
- 不要把防抖函数的创建逻辑写在
useEffect里直接绑定到属性上,否则首次输入时会因为防抖实例还没初始化出现逻辑断层 - 如果需要开启
cacheOptions属性,要确保缓存的key和防抖的输入值规则一致,避免重复请求 - 3秒的防抖延时在实际业务中偏长,一般推荐300-500ms的延时即可匹配用户输入节奏
内容的提问来源于stack exchange,提问作者Fadly Dzil
相关产品推荐
相关产品推荐

