TRPC项目中HTTP错误码与JSON-RPC错误码的映射机制解析

在TRPC项目中，开发者经常需要处理HTTP请求与响应过程中的错误情况。本文深入分析TRPC框架中HTTP状态码与JSON-RPC错误码之间的映射关系，以及如何扩展这一机制来满足更灵活的异常处理需求。

背景与问题场景

在基于TRPC的开发中，我们经常会遇到需要将HTTP请求的错误状态转换为TRPC错误码的情况。例如，当使用fetch API发起HTTP请求后，如果响应状态码表示错误，我们希望将这个HTTP错误转换为对应的TRPC错误码抛出。

现有机制分析

TRPC框架内部已经实现了从JSON-RPC错误码到HTTP状态码的映射关系。这个映射关系定义在JSONRPC2_TO_HTTP_CODE对象中，它将TRPC错误码(如BAD_REQUEST、UNAUTHORIZED等)映射到对应的HTTP状态码(如400、401等)。

这种单向映射在框架内部用于确定应该返回给客户端的HTTP状态码，但开发者无法直接利用这个映射关系进行反向转换。

解决方案设计

为了满足开发者将HTTP状态码转换为TRPC错误码的需求，我们可以扩展TRPC框架的功能：

1. 公开现有的JSONRPC2_TO_HTTP_CODE映射关系
2. 新增HTTP_CODE_TO_JSONRPC2反向映射关系
3. 提供辅助函数来简化转换过程

反向映射关系可以这样定义：

{
  400: 'BAD_REQUEST',
  401: 'UNAUTHORIZED',
  403: 'FORBIDDEN',
  404: 'NOT_FOUND',
  405: 'METHOD_NOT_SUPPORTED',
  // 其他映射...
}

实现建议

在实际实现时，需要注意几个关键点：

1. 一对一映射：确保每个HTTP状态码只映射到一个TRPC错误码
2. 默认处理：对于没有明确映射的状态码，应该回退到合理的默认错误码(如INTERNAL_SERVER_ERROR)
3. 类型安全：使用TypeScript的高级类型特性来保证类型安全

应用场景

这一改进将使得以下场景更加简洁：

const res = await fetch("api-url");
if (!res.ok) {
  throw new TRPCError({
    message: "请求失败",
    code: HTTP_CODE_TO_JSONRPC2[res.status] || 'INTERNAL_SERVER_ERROR'
  });
}

总结

TRPC框架作为现代TypeScript优先的RPC解决方案，其错误处理机制的设计直接影响开发体验。通过完善HTTP状态码与JSON-RPC错误码的双向映射关系，可以显著提升框架在复杂场景下的适用性，特别是在需要与现有HTTP API交互的混合应用中。这一改进将使错误处理更加一致和直观，同时保持TRPC的类型安全优势。