You need to enable JavaScript to run this app. Next.js博客接入Sanity.io code-input插件代码块渲染报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Next.js博客接入Sanity.io code-input插件代码块渲染报错如何解决

问题根源

@sanity/block-content-to-react内置的序列化规则仅支持Sanity默认的文本块、图片块等基础类型,完全不识别@sanity/code-input插件生成的_type: 'code'块结构,渲染时会因为找不到对应处理逻辑直接抛出异常。你之前看到的Gatsby适配方案本质是自定义序列化器,这套逻辑在Next.js中可以直接复用,不存在框架专属的特殊限制,也不需要在项目里找固定位置的serializer.js文件——这个文件本身就是开发者自定义的映射对象,没有强制的存放路径要求。

具体修复步骤
  • 修正GROQ查询的冗余逻辑
    你当前的查询把code作为和body平级的字段取出是错误的,code块本身是正文body块序列中的一员,不需要单独在查询里声明code字段。可将查询简化为:
    *[_type == "post" && slug.current == $slug][0]{
      title,
      "name": author->name,
      "categories": categories[]->title,
      mainImage,
      "authorImage": author->image,
      body
    }
    
    同时删除代码中给BlockContent传入的{...code}展开逻辑,这类冗余属性会干扰组件正常运行。
  • 编写自定义序列化规则
    直接在组件代码中定义序列化映射对象,匹配code类型的块结构,替换默认的异常渲染逻辑。最简单的基础渲染版本实现如下:
    const customSerializers = {
      types: {
        code: (props) => {
          // 从块节点中取出code块存储的语言、代码内容、文件名等字段
          const {language, code, filename} = props.node
          return (
            <div className="code-block">
              <div className="code-block__meta">
                {filename ? <span>{filename}</span> : null}
                <span>{language || '纯文本'}</span>
              </div>
              <pre>
                <code>{code}</code>
              </pre>
            </div>
          )
        }
      }
    }
    
  • 调整BlockContent组件的传参
    将自定义序列化器通过serializers属性传入组件,移除错误的冗余传参:
    <BlockContent                
      blocks={body}
      imageOptions={{fit: 'max'}}
      {...client.config()}
      serializers={customSerializers}
    />
    
额外注意事项
  • 若需要代码块的语法高亮效果,可直接在上述code块的渲染逻辑中接入轻量代码高亮库,不需要修改序列化器的核心映射逻辑。
  • 检查当前项目中@sanity/block-content-to-react的依赖版本,过低版本对自定义块类型的支持存在兼容bug,升级到最新稳定版即可规避。

内容的提问来源于stack exchange,提问作者theKid

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 04:36:03