Next.js getServerSideProps如何转context.query为字符串实现slug查询及报错解决
核心问题定位
- 对Next.js
getServerSideProps的context对象结构认知偏差:单段动态路由/v/[slug]的路由参数,需要从context.params下提取,不是直接把整个context.query对象作为slug值传入。context.query本身是存储URL查询参数的键值对对象(对应URL中?后的参数段),传入GraphQL变量时类型完全不匹配。 - 序列化报错的触发逻辑:因为传入的slug是对象而非有效字符串,GraphQL查询无法匹配到对应数据,最终返回的
VendorData为undefined,而getServerSideProps要求返回的props必须是可JSON序列化的值,不支持undefined类型,因此触发了序列化错误。
正确实现方案
- 优先从
context.params提取动态路由段的slug字符串,访问/v/xxx-shop这类路径时,context.params.slug会直接返回对应的'xxx-shop'字符串值。 - 增加空值判断与异常兜底:如果未拿到有效slug值,直接返回404状态;如果GraphQL查询抛出异常或无有效返回,将值设为
null,避免传入undefined触发序列化问题。 - 调整后的可运行代码:
export async function getServerSideProps(context){ const { API } = withSSRContext(context); // 从动态路由参数提取slug字符串 const slug = context.params?.slug; // 无有效slug时直接返回404 if (!slug) { return { notFound: true } } let VendorData = null; try { VendorData = await API.graphql({ query: getVendorBySlug, variables: { slug: slug } }); } catch (e) { // 查询异常时保持null值,不传入undefined VendorData = null; } return { props: { data: VendorData, } }; }
常见踩坑提示
- 不要直接将
context.query对象作为接口参数传入:context.query是包含所有URL查询参数的集合(比如?page=2&sort=price对应的结构是{page: '2', sort: 'price'}),不是具体的参数值。 - 动态路由参数不要依赖
context.query取值:路由文件定义的[slug]这类路径段参数,官方固定存在context.params中,从query中取属于不稳定的写法,很容易出现取不到值的情况。 - 所有传给getServerSideProps props的值,都要提前做类型校验,确保不存在
undefined,否则必然触发序列化报错。
内容的提问来源于stack exchange,提问作者James
相关产品推荐
相关产品推荐

