如何将GraphQL Schema上传至Dgraph数据库？

安全阿岳

2026-6-28

上传本地GraphQL Schema到Dgraph的正确方法

方法一：通过curl调用Admin API上传

这是批量上传的常用方式，也是解决你之前400错误的关键：

先确认本地schema文件（比如schema.graphql）无语法错误
使用以下curl命令，注意转义schema中的双引号以保证JSON格式合法：

curl -X POST http://<你的Dgraph地址>:8080/graphql/admin \
  -H "Content-Type: application/json" \
  -d '{ "query": "mutation { uploadSchema(schema: \"'$(sed 's/"/\\"/g' schema.graphql)'\" ) { message } }" }'

替换<你的Dgraph地址>为实际地址（本地环境通常填localhost）
sed 's/"/\\"/g'作用是将schema里的双引号转义为\"，避免JSON解析失败

方法二：启动Alpha节点时加载本地Schema

如果是初始化数据库，可直接在启动Dgraph Alpha节点时指定本地schema文件：

dgraph alpha --schema ./schema.graphql --zero localhost:5080

这种方式适合首次部署或重置数据库时使用，节点启动后会自动加载并应用schema。

方法三：通过GraphQL Playground上传

访问Dgraph的GraphQL Playground：http://<你的Dgraph地址>:8080/graphql
切换到Admin标签页，或直接在查询框中编写以下mutation，将本地schema内容粘贴到schema参数内：

mutation {
  uploadSchema(schema: """
    # 这里粘贴你的本地schema内容
    type User {
      id: ID!
      name: String!
      posts: [Post]
    }
    type Post {
      id: ID!
      title: String!
    }
  """) {
    message
  }
}

部分版本的Playground还支持直接点击Upload Schema按钮，选择本地schema.graphql文件完成上传。