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
相关产品推荐
相关产品推荐

