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
相关产品推荐
相关产品推荐

