Gatsby+Netlify CMS项目GraphQL本地正常 带frontmatter过滤Netlify返回null求助

这个问题的核心是Netlify构建环境下的Markdown frontmatter字段类型与本地仓库不一致，和gatsby-config.js的插件配置本身无关。
具体匹配逻辑差异：

• 本地构建时，仓库存储的vertical字段是标准布尔值false，因此GraphQL过滤器frontmatter: { vertical: { eq: false } }（匹配布尔型false）可以正常命中对应节点
• Netlify环境拉取的仓库内容，大多是Netlify CMS编辑保存后推送到Git的版本，此时vertical字段经常会被序列化为字符串值"false"，而非布尔类型的false
• GraphQL对字段过滤是强类型校验：用布尔值false匹配字符串类型的"false"字段，不会触发任何命中，最终返回查询结果null
• 你移除过滤条件后，因为没有值、类型的匹配约束，自然能正常返回所有文件节点，和你观察到的现象完全吻合。

按排查优先级依次操作即可：

• 第一步先验证字段实际类型：查看Netlify构建拉取的仓库中，product目录下对应Markdown文件的frontmatter段，如果vertical字段显示为vertical: "false"（带英文引号，为字符串类型），即可确认上述根因。
• 第二步临时兼容调整：修改GraphQL查询的过滤规则，同时兼容布尔、字符串两种类型的false值，避免类型不匹配。原查询对应的调整后代码如下：

  query {
    products_horizontal: file(
      sourceInstanceName: { eq: "products" }
      childMarkdownRemark: {
        frontmatter: {
          vertical: { in: [false, "false"] }
        }
      }
    ) {
      sourceInstanceName
      childMarkdownRemark {
        frontmatter {
          title
          date
          store
          vertical
          price
          image
          templateKey
          description
          featuredpost
          featuredimage
          tag
          color
        }
      }
    }
  }
  

• 第三步从源头统一字段类型：打开Netlify CMS的配置文件config.yml，找到vertical字段的定义，强制指定为布尔类型控件，从保存环节避免值被转成字符串。字段配置参考：

  - name: "vertical"
    label: "Vertical Layout Switch"
    widget: "boolean"
  

  配置生效后，CMS编辑保存时会写入标准布尔值，不会再出现类型不匹配的问题。
• 额外优化点：当前用file查询单节点拉取数据的写法存在隐患——如果符合过滤条件的Markdown文件有多个，GraphQL会直接抛出异常返回null，后续建议切换为allMarkdownRemark接口拉取符合条件的节点，按业务需求截取数量即可，避免多文件场景下的查询报错。

内容的提问来源于stack exchange，提问作者Rustam Quliyev