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字段。可将查询简化为:
同时删除代码中给BlockContent传入的*[_type == "post" && slug.current == $slug][0]{ title, "name": author->name, "categories": categories[]->title, mainImage, "authorImage": author->image, body }{...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
相关产品推荐
相关产品推荐

