You need to enable JavaScript to run this app. React TypeScript 自定义Hook致searchApi不可调用报错的解决方案
优惠活动
大模型
产品
解决方案
定价
更多

React TypeScript 自定义Hook致searchApi不可调用报错的解决方案

报错根因

两个核心问题共同触发了TypeScript编译错误:

  • 自定义Hook的返回值缺少明确的元组类型定义,导致TS推断逻辑异常
  • 数组解构的赋值顺序和Hook返回值顺序不匹配,存在潜在运行时bug

问题细节说明

  1. 类型推断异常逻辑
    你目前的Hook直接将三个值组成数组返回,TypeScript会默认将其推断为可变长度的普通数组,元素类型是三个返回值的联合类型:(searchTerm: string) => Promise<void> | [] | string。这种情况下TS不会绑定数组位置和对应类型的关系,导致所有解构出的变量类型都是这个全量联合类型——自然会出现“当前类型包含不可调用的字符串类型,无法执行调用操作”的报错。
  2. 解构顺序的运行时问题
    你的Hook返回值固定顺序为:
    [searchApi函数, results搜索结果状态, errorMessage错误提示状态]
    但你实际解构的顺序写为:
const [searchApi, errorMessage, results] = useResults();

相当于把第1位的搜索结果数组赋值给了错误提示变量,把第2位的错误提示字符串赋值给了搜索结果变量,只是因为两个状态的初始值都是空值,才没有立刻暴露运行时异常。

完整修复方案

第一步:给Hook返回值添加明确的元组类型标注

修改useResults的导出函数签名,明确声明返回值的固定类型结构,让TS可以准确识别每个解构变量的类型:

import { useEffect, useState } from 'react';
import yelp from '../api/yelp';

// 元组类型明确标注:依次为搜索函数、结果数组、错误字符串
export default (): [
  (searchTerm: string) => Promise<void>,
  any[],
  string
] => {
  const [results, setResults] = useState([]);
  const [errorMessage, setErrorMessage] = useState('');

  const searchApi = async (searchTerm:string) => {
    console.log('Hi there!');
    try {
      const response = await yelp.get('/search', {
        params: {
          limit: 50,
          term: searchTerm,
          location: 'san jose'
        }
      });
      setResults(response.data.businesses);
    } catch (err) {
      setErrorMessage('Something went wrong');
    }
  };

  useEffect(() => {
    searchApi('pasta');
  }, []);

  return [searchApi, results, errorMessage];
};

优化提示:如果项目中定义了Yelp返回的商户信息类型,可以将any[]替换为对应业务类型,进一步收紧类型校验规则。

第二步:修正解构顺序

将解构代码调整为和Hook返回值顺序完全对齐,避免运行时取值错误:

// 错误写法
// const [searchApi, errorMessage, results] = useResults();

// 正确写法
const [searchApi, results, errorMessage] = useResults();

第三步:SearchBar组件传参逻辑保持不变

完成上述两步修复后,你原本写的回调传入逻辑即可正常工作,不会再触发类型报错:

<SearchBar 
  term={term} 
  onTermChange={setTerm} 
  onTermSubmit={() => searchApi(term)}
/>

简化写法

如果不想手动编写元组类型标注,也可以在Hook返回数组时添加as const标记,让TS自动将返回值推断为只读固定元组,实现相同的类型校验效果:

// 返回时追加as const即可自动推断正确类型
return [searchApi, results, errorMessage] as const;

内容的提问来源于stack exchange,提问作者AMendis

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.09 13:15:11