You need to enable JavaScript to run this app. Gatsby对接Strapi图片时自定义Schema部署至DigitalOcean报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Gatsby对接Strapi图片时自定义Schema部署至DigitalOcean报错如何解决

问题排查与解决方案

你自定义的schema配置未生效核心是类型定义不符合GraphQL规范以及Gatsby的类型关联规则,按以下步骤修正即可:

1. 修正schema定义

你的原有代码存在两处核心错误:

  • GraphQL自定义类型名强制要求首字母大写,你定义的childImageSharp类型名小写不符合规范,会被Gatsby识别为无效类型
  • 字段关联层级错误:Strapi返回的媒体字段会先映射到localFile字段,再关联到childImageSharp,你之前的嵌套结构写错了
    修正后的代码如下:
exports.createSchemaCustomization = ({ actions }) => {
  const { createTypes } = actions
  const typeDefs = `
    type StrapiAbout implements Node {
      content: String
    }

    type StrapiPost implements Node  {
      slug: String
      content: String
      featured_image: StrapiMedia
    } 

    type StrapiMedia implements Node {
      localFile: File @link(from: "localFile___NODE")
    }

    type File implements Node {
      childImageSharp: ImageSharp
    }

    type ImageSharp implements Node {
      gatsbyImageData: JSON
    }
  `
  createTypes(typeDefs)
}

2. 其他排查点

  • 检查插件依赖:确认已安装gatsby-plugin-image、gatsby-plugin-sharp、gatsby-transformer-sharp,且gatsby-config.js中插件配置顺序正确,sharp相关插件要放在gatsby-source-strapi之后加载
  • 检查部署环境配置:确认DigitalOcean部署环境的Strapi API地址、访问密钥等环境变量和本地开发环境一致,避免部署时拉取不到数据导致字段缺失触发类型错误
  • 清理缓存构建:本地推送代码前执行gatsby clean清理缓存,也可以在DigitalOcean的构建命令前增加gatsby clean步骤,避免旧缓存的schema干扰构建
    如果上述操作后仍报错,可以在createSchemaCustomization中增加打印逻辑,输出实际拉取的Strapi字段结构,确认字段名和层级是否和定义的一致,排除拼写错误的问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.21 19:24:03