首页
/ Next-Safe-Action 项目即将支持自定义服务错误类型

Next-Safe-Action 项目即将支持自定义服务错误类型

2025-06-29 18:51:28作者:裴麒琰

在服务端与客户端交互的过程中,错误处理一直是开发者需要重点关注的环节。Next-Safe-Action 作为一个专注于提升 Next.js 应用安全性的库,其最新版本(v7)将带来一项重要改进:允许开发者自定义服务端错误的返回类型。

当前限制与改进方向

目前 Next-Safe-Action 在处理服务端错误时,强制要求错误信息必须是字符串类型。这在简单场景下尚可接受,但对于需要返回结构化错误信息的复杂应用就显得力不从心。例如:

  • 需要同时返回错误码和详细描述
  • 需要携带额外的错误上下文信息
  • 需要区分不同类型的错误响应

新版解决方案

v7版本将引入泛型支持,允许开发者通过配置自定义错误类型。核心改进点包括:

  1. 类型安全:通过TypeScript泛型确保整个错误处理流程的类型一致性
  2. 灵活处理:可以根据不同错误类型返回不同结构的数据
  3. 向后兼容:默认仍支持字符串类型,确保平滑升级

典型使用场景

假设我们需要处理以下两种错误情况:

// API返回的典型错误结构
interface ApiError {
  code: number;
  message: string;
  additional?: Record<string, unknown>;
}

// 特殊业务错误
interface BusinessError {
  instance: string;
  response: unknown;
}

新版实现方式:

const action = createSafeActionClient<ApiError | BusinessError>({
  handleReturnedServerError(e) {
    if (e instanceof FetchError) {
      return {
        code: e.response?._data?.code,
        message: e.response?._data?.message,
        additional: e.response?._data?.additional,
      };
    }

    if (e instanceof CustomError) {
      return {
        instance: e.response?._data?.instance,
        response: e.response?._data?.response,
      }
    }

    return DEFAULT_ERROR;
  }
});

技术实现要点

  1. 类型推断:客户端会自动推断出正确的错误类型
  2. 错误处理:开发者可以针对不同错误来源进行差异化处理
  3. 默认值:提供合理的默认错误结构,避免类型不一致

升级建议

对于现有项目:

  1. 小规模项目可以直接升级,继续使用字符串错误
  2. 复杂项目可以逐步迁移到结构化错误
  3. 建议在类型定义中明确区分预期错误和意外错误

这项改进将使Next-Safe-Action在错误处理方面更加灵活和强大,特别适合企业级应用和需要精细错误管理的场景。开发者现在可以构建类型更安全、信息更丰富的错误处理流程,提升应用的可维护性和用户体验。

登录后查看全文
热门项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
203
2.18 K
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
208
285
pytorchpytorch
Ascend Extension for PyTorch
Python
62
94
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
977
575
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
550
84
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
1.02 K
399
communitycommunity
本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息
393
27
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
1.2 K
133