RTK Query自定义queryFn时TypeScript返回值类型报错求助

问题根源 #

你的代码存在两处类型不匹配问题：

1. 功能开关关闭时的返回值不符合规范：直接返回Promise.resolve([])是错误的——RTK Query的queryFn要求返回**QueryReturnValue结构**（包含data/error/meta的对象），而非原始数组。
2. baseQuery 返回数据类型不兼容：baseQuery默认返回的data为unknown类型，无法匹配你定义的{ data: Fields[] }泛型类型。

修正方案 #

无需盲目使用类型断言，先按RTK Query规范修正返回结构，再给baseQuery指定返回类型即可解决：

type Fields = {
  name: string;
  dob: string;
}

// 定义接口匹配API返回结构
type FieldsApiResponse = {
  data: Fields[];
}

const fieldsApi = api.injectEndpoints({
  endpoints: (build) => ({
    getFields: build.query<FieldsApiResponse, void>({
      queryFn(arg, api, _, baseQuery) {
        const { featureFlags } = api.getState() as RootState;

        if (!featureFlags?.fieldsEnabled) {
          // 返回符合QueryReturnValue规范的结构，与泛型类型对齐
          return Promise.resolve({ data: { data: [] } });
        }

        // 给baseQuery指定泛型，让TypeScript识别返回数据结构
        return baseQuery<FieldsApiResponse>({ url: "/fields" });
      },
    })
  })
})

关键说明 #

• 关闭功能开关时，必须返回与泛型FieldsApiResponse一致的{ data: ... }结构，不能直接返回数组。
• 给baseQuery添加泛型<FieldsApiResponse>，可以让TypeScript自动推导返回数据类型，比类型断言更安全，避免强制转换带来的潜在风险。

内容的提问来源于stack exchange，提问作者topched