如何将HeadersInit转换为Object<string, string>类型？TypeScript兼容处理

因为RequestInit['headers']的类型可能是Headers实例、string[][]或者Record<string, string | number>，直接解构会因为类型不兼容、值类型非string导致TypeScript报错。你可以通过以下方式处理：

方法一：通用转换工具函数（推荐） #

写一个工具函数统一处理所有可能的headers类型，同时把所有值转为string：

function convertHeaders(headers: RequestInit['headers']): Record<string, string> {
  const formattedHeaders: Record<string, string> = {};

  if (!headers) return formattedHeaders;

  // 处理Headers对象
  if (headers instanceof Headers) {
    headers.forEach((value, key) => {
      formattedHeaders[key] = String(value);
    });
  }
  // 处理二维数组格式的headers（如 [['Content-Type', 'application/json'], ['X-Id', 123]]）
  else if (Array.isArray(headers)) {
    headers.forEach(([key, value]) => {
      formattedHeaders[key] = String(value);
    });
  }
  // 处理普通键值对对象
  else {
    Object.entries(headers).forEach(([key, value]) => {
      formattedHeaders[key] = String(value);
    });
  }

  return formattedHeaders;
}

使用方式：

headers: {
  ...convertHeaders(init?.headers),
},

方法二：简易对象转换（仅针对普通对象格式的headers） #

如果确定init.headers是普通对象类型，可以直接用Object.fromEntries快速转换：

headers: init?.headers 
  ? Object.fromEntries(
      Object.entries(init.headers as Record<string, unknown>).map(([key, val]) => [key, String(val)])
    )
  : {},

这两种方式都能确保最终的headers符合Object<string, string>类型要求，同时把number等非string类型的值转为字符串，消除TypeScript报错。

内容的提问来源于stack exchange，提问作者The Vanilla Thrilla