You need to enable JavaScript to run this app. Next.js getServerSideProps如何转context.query为字符串实现slug查询及报错解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.26 15:54:03