Hono框架中数组类型JSON响应导致类型推断丢失的问题分析

问题背景

在使用Hono框架开发API接口时，开发者发现当API返回的JSON数据是一个数组而非对象时，TypeScript的类型推断会失效。具体表现为返回数组类型数据时，客户端调用API后通过.json()方法获取到的值类型会被推断为never，而返回对象类型时则能正常推断。

问题复现

通过一个实际案例可以清晰展示这个问题：

const app = new Hono()
  .get("/", async (c) => {
    const data = await readData();
    return c.json(data);  // 正常情况
  })
  .get(
    "/filtration",
    zValidator(
      "query",
      z.object({
        pageSize: z.number().default(10),
      })
    ),
    async (c) => {
      const { pageSize } = c.req.valid("query");
      const data = await readData();
      const result = await splitArrayBySize(data, pageSize);
      return c.json(result);  // 类型推断失效
    }
  );

在客户端调用时：

client.api.issues.filtration.$get({ query: {} }).then((res) => {
  const value = res.json();  // value被推断为never类型
});

问题原因

经过深入分析，发现问题出在Hono框架对复杂数组类型的处理上。当API返回类似[number, IssuesDaum[]][]这样的嵌套数组类型时，Hono的类型系统会将其视为无效的JSON类型，导致TypeScript将其推断为never。

解决方案

目前有两种可行的解决方案：

1. 包装为对象返回：将数组数据包装在一个对象中返回

return c.json({ result });  // 正常推断

2. 等待框架修复：Hono团队已经确认这是一个需要修复的问题，后续版本会改进对数组类型的支持

技术细节

这个问题本质上源于Hono框架对JSON响应类型的校验逻辑不够完善。当前的类型检查只做了一层遍历，没有深入处理嵌套的数组结构。对于复杂的数组类型，如元组数组或嵌套数组，类型系统无法正确识别其有效性。

最佳实践建议

在Hono框架修复此问题前，建议开发者：

1. 尽量使用对象包装数组数据返回
2. 对于必须直接返回数组的场景，可以添加明确的类型断言
3. 关注Hono框架的更新，及时升级到修复此问题的版本

这个问题虽然不影响运行时功能，但会破坏TypeScript的类型安全优势，因此在开发中应当予以重视。