You need to enable JavaScript to run this app. Next.js结合getStaticProps使用SWR出现函数序列化报错
优惠活动
大模型
产品
解决方案
定价
更多

Next.js结合getStaticProps使用SWR出现函数序列化报错

报错触发原因

Next.js 的 getStaticProps 运行在服务端构建阶段,最终返回的 props 会被序列化为纯JSON注入页面,所有无法被JSON序列化的内容(函数、带方法的类实例、嵌套了函数的配置对象)都会直接触发序列化报错。
当前代码中,apis.getBestProduct 是基于axios这类HTTP客户端封装的请求方法,调用后返回的是完整的HTTP响应对象,而非接口返回的纯业务数据——报错信息中提到的 config.transformRequest[0] 就是axios响应自带的请求配置字段,里面包含大量函数,完全不符合序列化要求。

具体修复步骤
  • 调整 getStaticProps 中的取值逻辑,从HTTP响应中提取纯业务数据再传递给页面
    修改示例:
    export const getStaticProps: GetStaticProps = async () => {
      // 调用请求方法拿到完整HTTP响应
      const response = await apis.getBestProduct();
      // 仅提取接口返回的纯业务数据,剥离HTTP客户端自带的配置、方法类内容
      const pureInitialData = response.data;
      return {
        props: {
          initialData: pureInitialData
        }
      };
    };
    
  • 对齐客户端SWR的返回数据结构
    确保SWR配置中传入的fetcher(即apis.getBestProduct)返回的数据结构,和服务端提取的pureInitialData完全一致,避免出现水合时数据结构不匹配的问题。
    最优实践是在HTTP客户端的拦截器层统一做处理:所有请求响应自动提取response.data返回,让服务端、客户端调用同一个请求方法时,拿到的都是纯业务数据,从根源上避免把带函数的响应对象透传到props中。
  • 序列化校验
    修改完成后,可以在getStaticProps返回props前打印待传递的initialData,逐字段确认内容均为JSON可序列化类型(字符串、数字、普通对象、数组、布尔值、null),不存在嵌套的函数、HTTP配置对象。

注意:不要通过修改Next.js配置绕开序列化校验强行传递带函数的响应对象,哪怕绕过服务端序列化校验,客户端水合阶段也会因为数据结构不一致触发额外报错,最稳妥的方案就是在服务端只传递纯业务数据。

内容的提问来源于stack exchange,提问作者c01d-br0th3r

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 03:54:06