You need to enable JavaScript to run this app. Gatsby开发分页文章列表时报graphql查询残留编译代码错误
优惠活动
大模型
产品
解决方案
定价
更多

Gatsby开发分页文章列表时报graphql查询残留编译代码错误

错误原因
  • 核心原因是Gatsby的graphql查询标签本应在编译阶段被编译替换,却被保留到了运行时代码中触发了报错,你的场景下触发该问题的直接诱因是gatsby-node.js文件存在语法异常,干扰了Gatsby的编译流程:
    1. 注释掉的单篇文章创建代码存在语法错误:const slug = edge.node.frontmatter.slug, 行末尾错误使用了逗号而非分号,导致后续变量声明语法不符合规范
    2. 注释代码中调用了不存在的actions.createPages方法(多了末尾的s),正确的页面创建方法名为actions.createPage
  • 次要可能原因是Gatsby本地缓存损坏,导致编译逻辑异常
解决方法
  • 第一步:修正gatsby-node.js中的代码,要么直接删除无效的注释代码段,要么将其修正为正确写法:
// 创建单篇博客文章页
data.allMdx.edges.forEach(edge => {
    const slug = edge.node.frontmatter.slug
    const id = edge.node.id
    actions.createPage({
        path: slug,
        component: require.resolve(`./src/templates/singlePost.js`),
        context: {id},
    })
})
  • 第二步:清除Gatsby本地缓存后重启服务,执行以下命令:
gatsby clean && gatsby develop
  • 第三步:如果问题仍未解决,做两项检查:
    1. 确认allPosts.js中的export const pageQuery是写在文件顶层,没有嵌套在组件函数或其他代码块内部
    2. 确认你已经安装了gatsby-plugin-mdx、@mdx-js/react、gatsby-source-filesystem等必要依赖,且在gatsby-config.js中完成了正确配置

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.20 07:45:03